rfc9643.original		rfc9643.txt
	NETCONF Working Group K. Watsen		Internet Engineering Task Force (IETF) K. Watsen
	Internet-Draft Watsen Networks		Request for Comments: 9643 Watsen Networks
	Intended status: Standards Track M. Scharf		Category: Standards Track M. Scharf
	Expires: 7 October 2024 Hochschule Esslingen		ISSN: 2070-1721 Hochschule Esslingen
	5 April 2024		October 2024
	YANG Groupings for TCP Clients and TCP Servers		YANG Groupings for TCP Clients and TCP Servers
	draft-ietf-netconf-tcp-client-server-26
	Abstract		Abstract
	This document presents three YANG 1.1 modules to support the		This document presents three YANG 1.1 modules to support the
	configuration of TCP clients and TCP servers. The modules include		configuration of TCP clients and TCP servers. The modules include
	basic parameters of a TCP connection relevant for client or server		basic parameters of a TCP connection relevant for client or server
	applications, as well as client configuration required for traversing		applications, as well as client configuration required for traversing
	proxies. The modules can be used either standalone or in conjunction		proxies. The data models defined by these modules may be used
	with configuration of other stack protocol layers.		directly (e.g., to define a specific TCP client or TCP server) or in
			conjunction with the configuration defined for higher level protocols
	Editorial Note (To be removed by RFC Editor)		that depend on TCP (e.g., SSH, TLS, etc.). Examples of higher level
			protocol configuration designed to be used in conjunction with this
	This draft contains placeholder values that need to be replaced with		configuration are in RFCs 9644 and 9645.
	finalized values at the time of publication. This note summarizes
	all of the substitutions that are needed. No other RFC Editor
	instructions are specified elsewhere in this document.
	Artwork in this document contains shorthand references to drafts in
	progress. Please apply the following replacements:
	* AAAA --> the assigned RFC value for draft-ietf-netconf-crypto-
	types
	* DDDD --> the assigned RFC value for this draft
	Artwork in this document contains placeholder values for the date of
	publication of this draft. Please apply the following replacement:
	* 2024-04-04 --> the publication date of this draft
	The "Relation to other RFCs" section Section 1.1 contains the text
	"one or more YANG modules" and, later, "modules". This text is
	sourced from a file in a context where it is unknown how many modules
	a draft defines. The text is not wrong as is, but it may be improved
	by stating more directly how many modules are defined.
	The "Relation to other RFCs" section Section 1.1 contains a self-
	reference to this draft, along with a corresponding reference in the
	Appendix. Please replace the self-reference in this section with
	"This RFC" (or similar) and remove the self-reference in the
	"Normative/Informative References" section, whichever it is in.
	Tree-diagrams in this draft may use the '\' line-folding mode defined
	in RFC 8792. However, nicer-to-the-eye is when the '\\' line-folding
	mode is used. The AD suggested suggested putting a request here for
	the RFC Editor to help convert "ugly" '\' folded examples to use the
	'\\' folding mode. "Help convert" may be interpreted as, identify
	what looks ugly and ask the authors to make the adjustment.
	The following Appendix section is to be removed prior to publication:
	* Appendix A. Change Log
	Status of This Memo		Status of This Memo
	This Internet-Draft is submitted in full conformance with the		This is an Internet Standards Track document.
	provisions of BCP 78 and BCP 79.
	Internet-Drafts are working documents of the Internet Engineering
	Task Force (IETF). Note that other groups may also distribute
	working documents as Internet-Drafts. The list of current Internet-
	Drafts is at https://datatracker.ietf.org/drafts/current/.
	Internet-Drafts are draft documents valid for a maximum of six months		This document is a product of the Internet Engineering Task Force
	and may be updated, replaced, or obsoleted by other documents at any		(IETF). It represents the consensus of the IETF community. It has
	time. It is inappropriate to use Internet-Drafts as reference		received public review and has been approved for publication by the
	material or to cite them other than as "work in progress."		Internet Engineering Steering Group (IESG). Further information on
			Internet Standards is available in Section 2 of RFC 7841.
	This Internet-Draft will expire on 7 October 2024.		Information about the current status of this document, any errata,
			and how to provide feedback on it may be obtained at
			https://www.rfc-editor.org/info/rfc9643.
	Copyright Notice		Copyright Notice
	Copyright (c) 2024 IETF Trust and the persons identified as the		Copyright (c) 2024 IETF Trust and the persons identified as the
	document authors. All rights reserved.		document authors. All rights reserved.
	This document is subject to BCP 78 and the IETF Trust's Legal		This document is subject to BCP 78 and the IETF Trust's Legal
	Provisions Relating to IETF Documents (https://trustee.ietf.org/		Provisions Relating to IETF Documents
	license-info) in effect on the date of publication of this document.		(https://trustee.ietf.org/license-info) in effect on the date of
	Please review these documents carefully, as they describe your rights		publication of this document. Please review these documents
	and restrictions with respect to this document. Code Components		carefully, as they describe your rights and restrictions with respect
	extracted from this document must include Revised BSD License text as		to this document. Code Components extracted from this document must
	described in Section 4.e of the Trust Legal Provisions and are		include Revised BSD License text as described in Section 4.e of the
	provided without warranty as described in the Revised BSD License.		Trust Legal Provisions and are provided without warranty as described
			in the Revised BSD License.
	Table of Contents		Table of Contents
	1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 4		1. Introduction
	1.1. Relation to other RFCs . . . . . . . . . . . . . . . . . 4		1.1. Relation to Other RFCs
	1.2. Specification Language . . . . . . . . . . . . . . . . . 6		1.2. Specification Language
	1.3. Adherence to the NMDA . . . . . . . . . . . . . . . . . . 6		1.3. Adherence to the NMDA
	2. The "ietf-tcp-common" Module . . . . . . . . . . . . . . . . 6		1.4. Conventions
	2.1. Data Model Overview . . . . . . . . . . . . . . . . . . . 7		2. The "ietf-tcp-common" Module
	2.2. Example Usage . . . . . . . . . . . . . . . . . . . . . . 9		2.1. Data Model Overview
	2.3. YANG Module . . . . . . . . . . . . . . . . . . . . . . . 9		2.2. Example Usage
	3. The "ietf-tcp-client" Module . . . . . . . . . . . . . . . . 12		2.3. YANG Module
	3.1. Data Model Overview . . . . . . . . . . . . . . . . . . . 12		3. The "ietf-tcp-client" Module
	3.2. Example Usage . . . . . . . . . . . . . . . . . . . . . . 15		3.1. Data Model Overview
	3.3. YANG Module . . . . . . . . . . . . . . . . . . . . . . . 16		3.2. Example Usage
	4. The "ietf-tcp-server" Module . . . . . . . . . . . . . . . . 24		3.3. YANG Module
	4.1. Data Model Overview . . . . . . . . . . . . . . . . . . . 24		4. The "ietf-tcp-server" Module
	4.2. Example Usage . . . . . . . . . . . . . . . . . . . . . . 25		4.1. Data Model Overview
	4.3. YANG Module . . . . . . . . . . . . . . . . . . . . . . . 25		4.2. Example Usage
	5. Security Considerations . . . . . . . . . . . . . . . . . . . 28		4.3. YANG Module
	5.1. Considerations for the "ietf-tcp-common" YANG Module . . 28		5. Security Considerations
	5.2. Considerations for the "ietf-tcp-client" YANG Module . . 29		5.1. Considerations for the "ietf-tcp-common" YANG Module
	5.3. Considerations for the "ietf-tcp-server" YANG Module . . 30		5.2. Considerations for the "ietf-tcp-client" YANG Module
	6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 31		5.3. Considerations for the "ietf-tcp-server" YANG Module
	6.1. The "IETF XML" Registry . . . . . . . . . . . . . . . . . 31		6. IANA Considerations
	6.2. The "YANG Module Names" Registry . . . . . . . . . . . . 32		6.1. The IETF XML Registry
	7. References . . . . . . . . . . . . . . . . . . . . . . . . . 32		6.2. The YANG Module Names Registry
	7.1. Normative References . . . . . . . . . . . . . . . . . . 32		7. References
	7.2. Informative References . . . . . . . . . . . . . . . . . 33		7.1. Normative References
	Appendix A. Change Log . . . . . . . . . . . . . . . . . . . . . 35		7.2. Informative References
	A.1. 00 to 01 . . . . . . . . . . . . . . . . . . . . . . . . 35		Acknowledgements
	A.2. 01 to 02 . . . . . . . . . . . . . . . . . . . . . . . . 35		Authors' Addresses
	A.3. 02 to 03 . . . . . . . . . . . . . . . . . . . . . . . . 36
	A.4. 03 to 04 . . . . . . . . . . . . . . . . . . . . . . . . 36
	A.5. 04 to 05 . . . . . . . . . . . . . . . . . . . . . . . . 36
	A.6. 05 to 06 . . . . . . . . . . . . . . . . . . . . . . . . 36
	A.7. 06 to 07 . . . . . . . . . . . . . . . . . . . . . . . . 36
	A.8. 07 to 08 . . . . . . . . . . . . . . . . . . . . . . . . 36
	A.9. 08 to 09 . . . . . . . . . . . . . . . . . . . . . . . . 36
	A.10. 09 to 10 . . . . . . . . . . . . . . . . . . . . . . . . 37
	A.11. 10 to 11 . . . . . . . . . . . . . . . . . . . . . . . . 37
	A.12. 11 to 12 . . . . . . . . . . . . . . . . . . . . . . . . 37
	A.13. 12 to 13 . . . . . . . . . . . . . . . . . . . . . . . . 37
	A.14. 13 to 14 . . . . . . . . . . . . . . . . . . . . . . . . 37
	A.15. 14 to 15 . . . . . . . . . . . . . . . . . . . . . . . . 37
	A.16. 15 to 16 . . . . . . . . . . . . . . . . . . . . . . . . 38
	A.17. 16 to 17 . . . . . . . . . . . . . . . . . . . . . . . . 38
	A.18. 18 to 19 . . . . . . . . . . . . . . . . . . . . . . . . 38
	A.19. 18 to 19 . . . . . . . . . . . . . . . . . . . . . . . . 38
	A.20. 19 to 20 . . . . . . . . . . . . . . . . . . . . . . . . 38
	A.21. 20 to 22 . . . . . . . . . . . . . . . . . . . . . . . . 38
	A.22. 22 to 23 . . . . . . . . . . . . . . . . . . . . . . . . 39
	A.23. 23 to 24 . . . . . . . . . . . . . . . . . . . . . . . . 39
	A.24. 24 to 25 . . . . . . . . . . . . . . . . . . . . . . . . 39
	A.25. 25 to 26 . . . . . . . . . . . . . . . . . . . . . . . . 39
	Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . . 39
	Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 39
	1. Introduction		1. Introduction
	This document defines three YANG 1.1 [RFC7950] modules to support the		This document defines three YANG 1.1 [RFC7950] modules to support the
	configuration of TCP clients and TCP servers (TCP is defined in		configuration of TCP clients and TCP servers (TCP is defined in
	[RFC9293]), either as standalone or in conjunction with configuration		[RFC9293]). The data models defined by these modules may be used
	of other stack protocol layers.		directly (e.g., to define a specific TCP client or TCP server) or in
			conjunction with the configuration defined for higher level protocols
			that depend on TCP (e.g., SSH, TLS, etc.). Examples of higher level
			protocol configuration designed to be used in conjunction with this
			configuration are in [RFC9644] and [RFC9645].
	The modules focus on three different types of base TCP parameters		The modules focus on three different types of base TCP parameters
	that matter for TCP-based applications: First, the modules cover		that matter for TCP-based applications: First, the modules cover
	fundamental configuration of a TCP client or TCP server application,		fundamental configuration of a TCP client or TCP server application,
	such as addresses and port numbers. Second, a reusable grouping		such as addresses and port numbers. Second, a reusable grouping
	enables modification of application-specific parameters for a TCP		enables modification of application-specific parameters for TCP
	connections, such as use of TCP keep-alives. And third, client		connections, such as use of TCP keepalives. And third, client
	configuration for traversing proxies is included as well. In each		configuration for traversing proxies is included as well. In each
	case, the modules have a very narrow scope and focus on a minimum set		case, the modules have a very narrow scope and focus on a minimum set
	of required parameters.		of required parameters.
	Please be advised that while this document presents support for some		Please be advised that while this document presents support for some
	TCP proxy techniques, there are other TCP proxy techniques that are		TCP proxy techniques, there are other TCP proxy techniques that are
	not part of this document, but could be added by augmenting the YANG		not part of this document but could be added by augmenting the YANG
	module.		module.
	1.1. Relation to other RFCs		1.1. Relation to Other RFCs
	This document presents one or more YANG modules [RFC7950] that are		This document presents three YANG modules [RFC7950] that are part of
	part of a collection of RFCs that work together to, ultimately,		a collection of RFCs that work together to ultimately support the
	support the configuration of both the clients and servers of both the		configuration of both the clients and servers of both the Network
	NETCONF [RFC6241] and RESTCONF [RFC8040] protocols.		Configuration Protocol (NETCONF) [RFC6241] and RESTCONF [RFC8040].
	The dependency relationship between the primary YANG groupings		The dependency relationship between the primary YANG groupings
	defined in the various RFCs is presented in the below diagram. In		defined in the various RFCs is presented in the below diagram. In
	some cases, a draft may define secondary groupings that introduce		some cases, a document may define secondary groupings that introduce
	dependencies not illustrated in the diagram. The labels in the		dependencies not illustrated in the diagram. The labels in the
	diagram are a shorthand name for the defining RFC. The citation		diagram are shorthand names for the defining RFCs. The citation
	reference for shorthand name is provided below the diagram.		references for shorthand names are provided below the diagram.
	Please note that the arrows in the diagram point from referencer to		Please note that the arrows in the diagram point from referencer to
	referenced. For example, the "crypto-types" RFC does not have any		referenced. For example, the "crypto-types" RFC does not have any
	dependencies, whilst the "keystore" RFC depends on the "crypto-types"		dependencies, whilst the "keystore" RFC depends on the "crypto-types"
	RFC.		RFC.
	crypto-types		crypto-types
	^ ^		^ ^
	/ \		/ \
	/ \		/ \
	skipping to change at page 6, line 5 ¶		skipping to change at line 152 ¶
	| | | | | ^		| | | | | ^
	| | | +-----+ +---------+ |		| | | +-----+ +---------+ |
	| | | | | |		| | | | | |
	| +-----------|--------|--------------+ | |		| +-----------|--------|--------------+ | |
	| | | | | |		| | | | | |
	+-----------+ | | | | |		+-----------+ | | | | |
	| | | | | |		| | | | | |
	| | | | | |		| | | | | |
	netconf-client-server restconf-client-server		netconf-client-server restconf-client-server
	+======================+===========================================+		+========================+==========================+
	|Label in Diagram | Originating RFC |		| Label in Diagram | Reference |
	+======================+===========================================+		+========================+==========================+
	|crypto-types | [I-D.ietf-netconf-crypto-types] |		| crypto-types | [RFC9640] |
	+----------------------+-------------------------------------------+		+------------------------+--------------------------+
	|truststore | [I-D.ietf-netconf-trust-anchors] |		| truststore | [RFC9641] |
	+----------------------+-------------------------------------------+		+------------------------+--------------------------+
	|keystore | [I-D.ietf-netconf-keystore] |		| keystore | [RFC9642] |
	+----------------------+-------------------------------------------+		+------------------------+--------------------------+
	|tcp-client-server | [I-D.ietf-netconf-tcp-client-server] |		| tcp-client-server | RFC 9643 |
	+----------------------+-------------------------------------------+		+------------------------+--------------------------+
	|ssh-client-server | [I-D.ietf-netconf-ssh-client-server] |		| ssh-client-server | [RFC9644] |
	+----------------------+-------------------------------------------+		+------------------------+--------------------------+
	|tls-client-server | [I-D.ietf-netconf-tls-client-server] |		| tls-client-server | [RFC9645] |
	+----------------------+-------------------------------------------+		+------------------------+--------------------------+
	|http-client-server | [I-D.ietf-netconf-http-client-server] |		| http-client-server | [HTTP-CLIENT-SERVER] |
	+----------------------+-------------------------------------------+		+------------------------+--------------------------+
	|netconf-client-server | [I-D.ietf-netconf-netconf-client-server] |		| netconf-client-server | [NETCONF-CLIENT-SERVER] |
	+----------------------+-------------------------------------------+		+------------------------+--------------------------+
	|restconf-client-server| [I-D.ietf-netconf-restconf-client-server] |		| restconf-client-server | [RESTCONF-CLIENT-SERVER] |
	+----------------------+-------------------------------------------+		+------------------------+--------------------------+
	Table 1: Label in Diagram to RFC Mapping		Table 1: Label in Diagram to RFC Mapping
	1.2. Specification Language		1.2. Specification Language
	The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",		The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
	"SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and		"SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and
	"OPTIONAL" in this document are to be interpreted as described in BCP		"OPTIONAL" in this document are to be interpreted as described in
	14 [RFC2119] [RFC8174] when, and only when, they appear in all		BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all
	capitals, as shown here.		capitals, as shown here.
	1.3. Adherence to the NMDA		1.3. Adherence to the NMDA
	This document is compliant with the Network Management Datastore		This document is compliant with the Network Management Datastore
	Architecture (NMDA) [RFC8342]. It does not define any protocol		Architecture (NMDA) [RFC8342]. It does not define any protocol
	accessible nodes that are "config false".		accessible nodes that are "config false".
			1.4. Conventions
			Various examples in this document use the XML [W3C.REC-xml-20081126]
			encoding. Other encodings, such as JSON [RFC8259], could
			alternatively be used.
	2. The "ietf-tcp-common" Module		2. The "ietf-tcp-common" Module
	This section defines a YANG 1.1 module called "ietf-tcp-common". A		This section defines a YANG 1.1 module called "ietf-tcp-common". A
	high-level overview of the module is provided in Section 2.1.		high-level overview of the module is provided in Section 2.1.
	Examples illustrating the module's use are provided in Examples		Examples illustrating the module's use are provided in Section 2.2
	(Section 2.2). The YANG module itself is defined in Section 2.3.		("Example Usage"). The YANG module itself is defined in Section 2.3.
	2.1. Data Model Overview		2.1. Data Model Overview
	This section provides an overview of the "ietf-tcp-common" module in		This section provides an overview of the "ietf-tcp-common" module in
	terms of its features and groupings.		terms of its features and groupings.
	2.1.1. Model Scope		2.1.1. Model Scope
	This document presents a common "grouping" statement for basic TCP		This document presents a common "grouping" statement for basic TCP
	connection parameters that matter to applications. It is "common" in		connection parameters that matter to applications. It is "common" in
	that this grouping is used by both the "ietf-tcp-client" and "ietf-		that this grouping is used by both the "ietf-tcp-client" and "ietf-
	tcp-server" modules. In some TCP stacks, such parameters can also		tcp-server" modules. In some TCP stacks, such parameters can also
	directly be set by an application using system calls, such as the		directly be set by an application using system calls, such as the
	sockets API. The base YANG model in this document focuses on		sockets API. The base YANG data model in this document focuses on
	modeling TCP keep-alives. This base model can be extended as needed.		modeling TCP keepalives. This base model can be extended as needed.
	2.1.2. Features		2.1.2. Features
	The following diagram lists all the "feature" statements defined in		The following diagram lists all the "feature" statements defined in
	the "ietf-tcp-common" module:		the "ietf-tcp-common" module:
	Features:		Features:
	+-- keepalives-supported		+-- keepalives-supported
	The diagram above uses syntax that is similar to but not defined in		The diagram above uses syntax that is similar to but not defined in
	skipping to change at page 8, line 13 ¶		skipping to change at line 259 ¶
	Comments:		Comments:
	* The "keepalives" node is a "presence" container so that the		* The "keepalives" node is a "presence" container so that the
	mandatory descendant nodes do not imply that keepalives must be		mandatory descendant nodes do not imply that keepalives must be
	configured.		configured.
	* The "idle-time", "max-probes", and "probe-interval" nodes have the		* The "idle-time", "max-probes", and "probe-interval" nodes have the
	common meanings. Please see the YANG module in Section 2.3 for		common meanings. Please see the YANG module in Section 2.3 for
	details.		details.
	2.1.4. Protocol-accessible Nodes		2.1.4. Protocol-Accessible Nodes
	The "ietf-tcp-common" module defines only "grouping" statements that		The "ietf-tcp-common" module defines only "grouping" statements that
	are used by other modules to instantiate protocol-accessible nodes.		are used by other modules to instantiate protocol-accessible nodes.
	Thus this module, when implemented, does not itself define any		Thus, this module, when implemented, does not itself define any
	protocol-accessible nodes.		protocol-accessible nodes.
	2.1.5. Guidelines for Configuring TCP Keep-Alives		2.1.5. Guidelines for Configuring TCP Keepalives
	Network stacks may include "keep-alives" in their TCP		Network stacks may include keepalives in their TCP implementations,
	implementations, although this practice is not universally		although this practice is not universally implemented. If keepalives
	implemented. If keep-alives are included, [RFC9293] mandates that		are included, [RFC9293] mandates that the application MUST be able to
	the application MUST be able to turn them on or off for each TCP		turn them on or off for each TCP connection and that they MUST
	connection, and that they MUST default to off.		default to off.
	Keep-alive mechanisms exist in many protocols. Depending on the		Keepalive mechanisms exist in many protocols. Depending on the
	protocol stack, TCP keep-alives may only be one out of several		protocol stack, TCP keepalives may only be one out of several
	alternatives. Which mechanism(s) to use depends on the use case and		alternatives. Which mechanism(s) to use depends on the use case and
	application requirements. If keep-alives are needed by an		application requirements. If keepalives are needed by an
	application, it is RECOMMENDED that the liveness check happens only		application, it is RECOMMENDED that the liveness check happens only
	at the protocol layers that are meaningful to the application.		at the protocol layers that are meaningful to the application.
	A TCP keep-alive mechanism SHOULD only be invoked in server		A TCP keepalive mechanism SHOULD only be invoked in server
	applications that might otherwise hang indefinitely and consume		applications that might otherwise hang indefinitely and consume
	resources unnecessarily if a client crashes or aborts a connection		resources unnecessarily if a client crashes or aborts a connection
	during a network failure [RFC9293]. TCP keep-alives may consume		during a network failure [RFC9293]. TCP keepalives may consume
	significant resources both in the network and in endpoints (e.g.,		significant resources both in the network and in endpoints (e.g.,
	battery power). In addition, frequent keep-alives risk network		battery power). In addition, frequent keepalives risk network
	congestion. The higher the frequency of keep-alives, the higher the		congestion. The higher the frequency of keepalives, the higher the
	overhead.		overhead.
	Given the cost of keep-alives, parameters have to be configured		Given the cost of keepalives, parameters have to be configured
	carefully:		carefully:
	* The default idle interval (leaf "idle-time") is two hours, i.e.,		* The default idle interval (leaf "idle-time") is two hours, i.e.,
	7200 seconds [RFC9293]. A lower value MAY be configured, but idle		7200 seconds [RFC9293]. A lower value MAY be configured, but idle
	intervals SHOULD NOT be smaller than 15 seconds. Longer idle		intervals SHOULD NOT be smaller than 15 seconds. Longer idle
	intervals SHOULD be used when possible.		intervals SHOULD be used when possible.
	* The maximum number of sequential keep-alive probes that can fail		* The maximum number of sequential keepalive probes that can fail
	(leaf "max-probes") trades off responsiveness and robustness		(leaf "max-probes") trades off responsiveness and robustness
	against packet loss. ACK segments that contain no data are not		against packet loss. ACK segments that contain no data are not
	reliably transmitted by TCP. Consequently, if a keep-alive		reliably transmitted by TCP. Consequently, if a keepalive
	mechanism is implemented it MUST NOT interpret failure to respond		mechanism is implemented, it MUST NOT interpret failure to respond
	to any specific probe as a dead connection [RFC9293]. Typically,		to any specific probe as a dead connection [RFC9293]. Typically,
	a single-digit number should suffice.		a single-digit number should suffice.
	* TCP implementations may include a parameter for the number of		* TCP implementations may include a parameter for the number of
	seconds between TCP keep-alive probes (leaf "probe-interval"). In		seconds between TCP keepalive probes (leaf "probe-interval"). In
	order to avoid congestion, the time interval between probes MUST		order to avoid congestion, the time interval between probes MUST
	NOT be smaller than one second. Significantly longer intervals		NOT be smaller than one second. Significantly longer intervals
	SHOULD be used. It is important to note that keep-alive probes		SHOULD be used. It is important to note that keepalive probes (or
	(or replies) can get dropped due to network congestion. Sending		replies) can get dropped due to network congestion. Sending
	further probe messages into a congested path after a short		further probe messages into a congested path after a short
	interval, without backing off timers, could cause harm and result		interval, without backing off timers, could cause harm and result
	in a congestion collapse. Therefore it is essential to pick a		in a congestion collapse. Therefore, it is essential to pick a
	large, conservative value for this interval.		large, conservative value for this interval.
	2.2. Example Usage		2.2. Example Usage
	This section presents an example showing the "tcp-common-grouping"		This section presents an example showing the "tcp-common-grouping"
	populated with some data.		grouping populated with some data.
	<!-- The outermost element below doesn't exist in the data model. -->		<!-- The outermost element below doesn't exist in the data model. -->
	<!-- It simulates if the "grouping" were a "container" instead. -->		<!-- It simulates if the "grouping" were a "container" instead. -->
	<tcp-common xmlns="urn:ietf:params:xml:ns:yang:ietf-tcp-common">		<tcp-common xmlns="urn:ietf:params:xml:ns:yang:ietf-tcp-common">
	<keepalives>		<keepalives>
	<idle-time>7200</idle-time>		<idle-time>7200</idle-time>
	<max-probes>9</max-probes>		<max-probes>9</max-probes>
	<probe-interval>75</probe-interval>		<probe-interval>75</probe-interval>
	</keepalives>		</keepalives>
	</tcp-common>		</tcp-common>
	2.3. YANG Module		2.3. YANG Module
	The ietf-tcp-common YANG module references [RFC6991] and [RFC9293].		The "ietf-tcp-common" YANG module references [RFC6991] and [RFC9293].
	<CODE BEGINS> file "ietf-tcp-common@2024-04-04.yang"		<CODE BEGINS> file "ietf-tcp-common@2024-04-04.yang"
	module ietf-tcp-common {		module ietf-tcp-common {
	yang-version 1.1;		yang-version 1.1;
	namespace "urn:ietf:params:xml:ns:yang:ietf-tcp-common";		namespace "urn:ietf:params:xml:ns:yang:ietf-tcp-common";
	prefix tcpcmn;		prefix tcpcmn;
	organization		organization
	"IETF NETCONF (Network Configuration) Working Group and the		"IETF NETCONF (Network Configuration) Working Group and the
	IETF TCP Maintenance and Minor Extensions (TCPM) Working Group";		IETF TCP Maintenance and Minor Extensions (TCPM) Working Group";
	contact		contact
	"WG Web: https://datatracker.ietf.org/wg/netconf		"WG Web: https://datatracker.ietf.org/wg/netconf
	https://datatracker.ietf.org/wg/tcpm		https://datatracker.ietf.org/wg/tcpm
	WG List: NETCONF WG list <mailto:netconf@ietf.org>		WG List: NETCONF WG list <mailto:netconf@ietf.org>
	TCPM WG list <mailto:tcpm@ietf.org>		TCPM WG list <mailto:tcpm@ietf.org>
	Authors: Kent Watsen <mailto:kent+ietf@watsen.net>		Authors: Kent Watsen <mailto:kent+ietf@watsen.net>
	Michael Scharf		Michael Scharf
	<mailto:michael.scharf@hs-esslingen.de>";		<mailto:michael.scharf@hs-esslingen.de>";
	description		description
	"This module define a reusable 'grouping' that is common		"This module define a reusable 'grouping' that is common
	to both TCP-clients and TCP-servers. This grouping statement		to both TCP clients and TCP servers. This grouping statement
	is used by both the 'ietf-tcp-client' and 'ietf-tcp-server'		is used by both the 'ietf-tcp-client' and 'ietf-tcp-server'
	modules.		modules.
	Copyright (c) 2023 IETF Trust and the persons identified		The key words 'MUST', 'MUST NOT', 'REQUIRED', 'SHALL',
	as authors of the code. All rights reserved.		'SHALL NOT', 'SHOULD', 'SHOULD NOT', 'RECOMMENDED',
			'NOT RECOMMENDED', 'MAY', and 'OPTIONAL' in this document
			are to be interpreted as described in BCP 14 (RFC 2119)
			(RFC 8174) when, and only when, they appear in all
			capitals, as shown here.
			Copyright (c) 2024 IETF Trust and the persons identified
			as authors of the code. All rights reserved.
	Redistribution and use in source and binary forms, with		Redistribution and use in source and binary forms, with
	or without modification, is permitted pursuant to, and		or without modification, is permitted pursuant to, and
	subject to the license terms contained in, the Revised		subject to the license terms contained in, the Revised
	BSD License set forth in Section 4.c of the IETF Trust's		BSD License set forth in Section 4.c of the IETF Trust's
	Legal Provisions Relating to IETF Documents		Legal Provisions Relating to IETF Documents
	(https://trustee.ietf.org/license-info).		(https://trustee.ietf.org/license-info).
	This version of this YANG module is part of RFC DDDD		This version of this YANG module is part of RFC 9643
	(https://www.rfc-editor.org/info/rfcDDDD); see the RFC		(https://www.rfc-editor.org/info/rfc9643); see the RFC
	itself for full legal notices.		itself for full legal notices.";
	The key words 'MUST', 'MUST NOT', 'REQUIRED', 'SHALL',
	'SHALL NOT', 'SHOULD', 'SHOULD NOT', 'RECOMMENDED',
	'NOT RECOMMENDED', 'MAY', and 'OPTIONAL' in this document
	are to be interpreted as described in BCP 14 (RFC 2119)
	(RFC 8174) when, and only when, they appear in all
	capitals, as shown here.";
	revision 2024-04-04 {		revision 2024-04-04 {
	description		description
	"Initial version";		"Initial version.";
	reference		reference
	"RFC DDDD: YANG Groupings for TCP Clients and TCP Servers";		"RFC 9643: YANG Groupings for TCP Clients and TCP Servers";
	}		}
	// Features		// Features
	feature keepalives-supported {		feature keepalives-supported {
	description		description
	"Indicates that keepalives are supported.";		"Indicates that keepalives are supported.";
	}		}
	// Groupings		// Groupings
	grouping tcp-common-grouping {		grouping tcp-common-grouping {
	description		description
	"A reusable grouping for configuring TCP parameters common		"A reusable grouping for configuring TCP parameters common
	to TCP connections as well as the operating system as a		to TCP connections as well as the operating system as a
	whole.";		whole.";
	container keepalives {		container keepalives {
	if-feature "keepalives-supported";		if-feature "keepalives-supported";
	presence		presence "Indicates that keepalives are enabled, aligning to
	"Indicates that keepalives are enabled, aligning to		the requirement in Section 3.8.4 of RFC 9293 that
	the requirement in Section 3.8.4 RFC 9293 that		states keepalives are off by default.";
	keepalives are off by default.";
	description		description
	"Configures the keep-alive policy, to proactively test the		"Configures the keepalive policy to proactively test the
	aliveness of the TCP peer. An unresponsive TCP peer is		aliveness of the TCP peer. An unresponsive TCP peer is
	dropped after approximately (idle-time + max-probes *		dropped after approximately (idle-time + max-probes *
	probe-interval) seconds. Further guidance can be found		probe-interval) seconds. Further guidance can be found
	in Section 2.1.5 of RFC DDDD.";		in Section 2.1.5 of RFC 9643.";
	reference		reference
	"RFC 9293: Transmission Control Protocol (TCP)";		"RFC 9293: Transmission Control Protocol (TCP)";
	leaf idle-time {		leaf idle-time {
	type uint16 {		type uint16 {
	range "1..max";		range "1..max";
	}		}
	units "seconds";		units "seconds";
	default 7200;		default "7200";
	description		description
	"Sets the amount of time after which if no data has been		"Sets the amount of time after which a TCP-level probe
	received from the TCP peer, a TCP-level probe message		message will be sent to test the aliveness of the TCP
	will be sent to test the aliveness of the TCP peer.		peer if no data has been received from the TCP peer.
	Two hours (7200 seconds) is safe value, per RFC 9293		Two hours (7200 seconds) is a safe value, per Section
	Section 3.8.4.";		3.8.4 of RFC 9293.";
	reference		reference
	"RFC 9293: Transmission Control Protocol (TCP)";		"RFC 9293: Transmission Control Protocol (TCP)";
	}		}
	leaf max-probes {		leaf max-probes {
	type uint16 {		type uint16 {
	range "1..max";		range "1..max";
	}		}
	default 9;		default "9";
	description		description
	"Sets the maximum number of sequential keep-alive probes		"Sets the maximum number of sequential keepalive probes
	that can fail to obtain a response from the TCP peer		that can fail to obtain a response from the TCP peer
	before assuming the TCP peer is no longer alive.";		before assuming the TCP peer is no longer alive.";
	}		}
	leaf probe-interval {		leaf probe-interval {
	type uint16 {		type uint16 {
	range "1..max";		range "1..max";
	}		}
	units "seconds";		units "seconds";
	default 75;		default "75";
	description		description
	"Sets the time interval between failed probes. The interval		"Sets the time interval between failed probes. The
	SHOULD be significantly longer than one second in order to		interval SHOULD be significantly longer than one second
	avoid harm on a congested link.";		in order to avoid harm on a congested link.";
	}		}
	} // container keepalives		} // container keepalives
	} // grouping tcp-common-grouping		} // grouping tcp-common-grouping
	}		}
	<CODE ENDS>		<CODE ENDS>
	3. The "ietf-tcp-client" Module		3. The "ietf-tcp-client" Module
	This section defines a YANG 1.1 module called "ietf-tcp-client". A		This section defines a YANG 1.1 module called "ietf-tcp-client". A
	high-level overview of the module is provided in Section 3.1.		high-level overview of the module is provided in Section 3.1.
	Examples illustrating the module's use are provided in Examples		Examples illustrating the module's use are provided in Section 3.2
	(Section 3.2). The YANG module itself is defined in Section 3.3.		("Example Usage"). The YANG module itself is defined in Section 3.3.
	3.1. Data Model Overview		3.1. Data Model Overview
	This section provides an overview of the "ietf-tcp-client" module in		This section provides an overview of the "ietf-tcp-client" module in
	terms of its features and groupings.		terms of its features and groupings.
	3.1.1. Features		3.1.1. Features
	The following diagram lists all the "feature" statements defined in		The following diagram lists all the "feature" statements defined in
	the "ietf-tcp-client" module:		the "ietf-tcp-client" module:
	skipping to change at page 13, line 7 ¶		skipping to change at line 490 ¶
	+-- socks4-supported {proxy-connect}?		+-- socks4-supported {proxy-connect}?
	+-- socks4a-supported {proxy-connect}?		+-- socks4a-supported {proxy-connect}?
	+-- socks5-supported {proxy-connect}?		+-- socks5-supported {proxy-connect}?
	+-- socks5-gss-api {socks5-supported}?		+-- socks5-gss-api {socks5-supported}?
	+-- socks5-username-password {socks5-supported}?		+-- socks5-username-password {socks5-supported}?
	Comments:		Comments:
	* The "local-binding-supported" feature indicates that the server		* The "local-binding-supported" feature indicates that the server
	supports configuring local bindings (i.e., the local address and		supports configuring local bindings (i.e., the local address and
	local port) for TCP clients."		local port) for TCP clients.
	* The "tcp-client-keepalives" feature indicates that per socket TCP		* The "tcp-client-keepalives" feature indicates that TCP keepalive
	keepalive parameters are configurable for TCP clients on the		parameters are configurable for TCP clients on the server
	server implementing this feature.		implementing this feature.
	* The "proxy-connect" feature indicates the TCP-client supports		* The "proxy-connect" feature indicates the TCP client supports
	connecting through TCP proxies.		connecting through TCP proxies.
	* The "socks4-supported" feature indicates the TCP-client supports		* The "socks4-supported" feature indicates the TCP client supports
	Socks4-based proxies.		Socks4-based proxies.
	* The "socks4a-supported" feature indicates the TCP-client supports		* The "socks4a-supported" feature indicates the TCP client supports
	Socks4a-based proxies. The difference between Socks4 and Socks4a		Socks4a-based proxies. The difference between Socks4 and Socks4a
	is that Socks4a enables the "remote-address" to be specified using		is that Socks4a enables the "remote-address" to be specified using
	a hostname, in addition to an IP address.		a hostname, in addition to an IP address.
	* The "socks5-supported" feature indicates the TCP-client supports		* The "socks5-supported" feature indicates the TCP client supports
	Socks5-based proxies.		Socks5-based proxies.
	* The "socks5-gss-api" feature indicates that the server, when		* The "socks5-gss-api" feature indicates that the server, when
	acting as a TCP-client, supports authenticating to a SOCKS Version		acting as a TCP client, supports authenticating to a SOCKS Version
	5 proxy server using GSSAPI credentials.		5 proxy server using Generic Security Service Application Program
			Interface (GSS-API) credentials.
	* The "socks5-username-password" feature indicates that the server,		* The "socks5-username-password" feature indicates that the server,
	when acting as a TCP-client, supports authenticating to a SOCKS		when acting as a TCP client, supports authenticating to a SOCKS
	Version 5 proxy server using 'username' and 'password'		Version 5 proxy server using "username" and "password"
	credentials."		credentials."
	The diagram above uses syntax that is similar to but not defined in		The diagram above uses syntax that is similar to but not defined in
	[RFC8340].		[RFC8340].
	3.1.2. Groupings		3.1.2. Groupings
	The "ietf-tcp-client" module defines the following "grouping"		The "ietf-tcp-client" module defines the following "grouping"
	statement:		statement:
	skipping to change at page 14, line 42 ¶		skipping to change at line 574 ¶
	| +-- username-password		| +-- username-password
	| +-- username string		| +-- username string
	| +---u ct:password-grouping		| +---u ct:password-grouping
	+---u tcpcmn:tcp-common-grouping		+---u tcpcmn:tcp-common-grouping
	Comments:		Comments:
	* The "remote-address" node, which is mandatory, may be configured		* The "remote-address" node, which is mandatory, may be configured
	as an IPv4 address, an IPv6 address, or a hostname.		as an IPv4 address, an IPv6 address, or a hostname.
	* The "remote-port" node is not mandatory, but its default value is		* The "remote-port" leaf is defined with neither a "default" nor a
	the invalid value '0', thus forcing the consuming data model to		"mandatory" statement. YANG modules using this grouping SHOULD
	refine it in order to provide it an appropriate default value.		refine the grouping with a "default" statement, when the port
			number is well-known (e.g., a port number allocated by IANA), or
			with a "mandatory" statement, if a port number needs to always be
			configured. The SHOULD can be ignored when the port number is
			neither well-known nor mandatory to configure, such as might be
			the case when this grouping is used by another grouping.
	* The "local-address" node, which is enabled by the "local-binding-		* The "local-address" node, which is enabled by the "local-binding-
	supported" feature (Section 2.1.2), may be configured as an IPv4		supported" feature (Section 3.1.1), may be configured as an IPv4
	address, an IPv6 address, or a wildcard value.		address, an IPv6 address, or a wildcard value.
	* The "local-port" node, which is enabled by the "local-binding-		* The "local-port" node, which is enabled by the "local-binding-
	supported" feature (Section 2.1.2), is not mandatory. Its default		supported" feature (Section 3.1.1), is not mandatory. Its default
	value is '0', indicating that the operating system can pick an		value is "0", indicating that the operating system can pick an
	arbitrary port number.		arbitrary port number.
	* The "proxy-server" node is enabled by a "feature" statement and,		* The "proxy-server" node is enabled by a "feature" statement and,
	for servers that enable it, is a "presence" container so that the		for servers that enable it, is a "presence" container so that the
	descendant "mandatory true" choice node does not imply that the		descendant "mandatory true" choice node does not imply that the
	proxy-server node must be configured. The proxy-server node uses		proxy-server node must be configured. The proxy-server node uses
	a "choice" statement to allow one of several types of proxies to		a "choice" statement to allow one of several types of proxies to
	be configured. The choices presented in this document include		be configured. The choices presented in this document include
	Socks4, Socks4a, and Socks5, each enabled by a YANG feature (see		Socks4, Socks4a, and Socks5, each enabled by a YANG feature (see
	Section 3.1.1). Other proxy types may be added by future work.		Section 3.1.1). Other proxy types may be added by future work.
	* This grouping uses the "password-grouping" grouping discussed in		* This grouping uses the "password-grouping" grouping discussed in
	[I-D.ietf-netconf-crypto-types].		[RFC9640].
	* This grouping uses the "tcp-common-grouping" grouping discussed in		* This grouping uses the "tcp-common-grouping" grouping discussed in
	Section 2.1.3.1.		Section 2.1.3.1.
	3.1.3. Protocol-accessible Nodes		3.1.3. Protocol-Accessible Nodes
	The "ietf-tcp-client" module defines only "grouping" statements that		The "ietf-tcp-client" module defines only "grouping" statements that
	are used by other modules to instantiate protocol-accessible nodes.		are used by other modules to instantiate protocol-accessible nodes.
	Thus this module, when implemented, does not itself define any		Thus, this module, when implemented, does not itself define any
	protocol-accessible nodes.		protocol-accessible nodes.
	3.2. Example Usage		3.2. Example Usage
	This section presents two examples showing the "tcp-client-grouping"		This section presents two examples showing the "tcp-client-grouping"
	populated with some data. This example shows a TCP-client configured		grouping populated with some data. This example shows a TCP client
	to not connect via a proxy:		configured to not connect via a proxy:
	<!-- The outermost element below doesn't exist in the data model. -->		<!-- The outermost element below doesn't exist in the data model. -->
	<!-- It simulates if the "grouping" were a "container" instead. -->		<!-- It simulates if the "grouping" were a "container" instead. -->
	<tcp-client xmlns="urn:ietf:params:xml:ns:yang:ietf-tcp-client">		<tcp-client xmlns="urn:ietf:params:xml:ns:yang:ietf-tcp-client">
	<remote-address>www.example.com</remote-address>		<remote-address>www.example.com</remote-address>
	<remote-port>8443</remote-port>		<remote-port>8443</remote-port>
	<local-address>192.0.2.2</local-address>		<local-address>192.0.2.2</local-address>
	<local-port>12345</local-port>		<local-port>12345</local-port>
	<keepalives>		<keepalives>
	<idle-time>7200</idle-time>		<idle-time>7200</idle-time>
	<max-probes>9</max-probes>		<max-probes>9</max-probes>
	<probe-interval>75</probe-interval>		<probe-interval>75</probe-interval>
	</keepalives>		</keepalives>
	</tcp-client>		</tcp-client>
	This example shows a TCP-client configured to connect via a proxy:
			This example shows a TCP client configured to connect via a proxy.
	<!-- The outermost element below doesn't exist in the data model. -->		<!-- The outermost element below doesn't exist in the data model. -->
	<!-- It simulates if the "grouping" were a "container" instead. -->		<!-- It simulates if the "grouping" were a "container" instead. -->
	<tcp-client xmlns="urn:ietf:params:xml:ns:yang:ietf-tcp-client">		<tcp-client xmlns="urn:ietf:params:xml:ns:yang:ietf-tcp-client">
	<remote-address>www.example.com</remote-address>		<remote-address>www.example.com</remote-address>
	<remote-port>8443</remote-port>		<remote-port>8443</remote-port>
	<local-address>192.0.2.2</local-address>		<local-address>192.0.2.2</local-address>
	<local-port>12345</local-port>		<local-port>12345</local-port>
	<proxy-server>		<proxy-server>
	skipping to change at page 16, line 35 ¶		skipping to change at line 666 ¶
	</proxy-server>		</proxy-server>
	<keepalives>		<keepalives>
	<idle-time>7200</idle-time>		<idle-time>7200</idle-time>
	<max-probes>9</max-probes>		<max-probes>9</max-probes>
	<probe-interval>75</probe-interval>		<probe-interval>75</probe-interval>
	</keepalives>		</keepalives>
	</tcp-client>		</tcp-client>
	3.3. YANG Module		3.3. YANG Module
	The ietf-tcp-client YANG module references [SOCKS_4A], [RFC1928],		The "ietf-tcp-client" YANG module references [SOCKS], [SOCKS_4A],
	[RFC1929], [RFC2743], [RFC6991], [RFC9293], and		[RFC1928], [RFC1929], [RFC2743], [RFC6991], [RFC9293], and [RFC9640].
	[I-D.ietf-netconf-crypto-types].
	<CODE BEGINS> file "ietf-tcp-client@2024-04-04.yang"		<CODE BEGINS> file "ietf-tcp-client@2024-04-04.yang"
	module ietf-tcp-client {		module ietf-tcp-client {
	yang-version 1.1;		yang-version 1.1;
	namespace "urn:ietf:params:xml:ns:yang:ietf-tcp-client";		namespace "urn:ietf:params:xml:ns:yang:ietf-tcp-client";
	prefix tcpc;		prefix tcpc;
	import ietf-inet-types {		import ietf-inet-types {
	prefix inet;		prefix inet;
	reference		reference
	"RFC 6991: Common YANG Data Types";		"RFC 6991: Common YANG Data Types";
	}		}
	skipping to change at page 17, line 4 ¶		skipping to change at line 680 ¶
	module ietf-tcp-client {		module ietf-tcp-client {
	yang-version 1.1;		yang-version 1.1;
	namespace "urn:ietf:params:xml:ns:yang:ietf-tcp-client";		namespace "urn:ietf:params:xml:ns:yang:ietf-tcp-client";
	prefix tcpc;		prefix tcpc;
	import ietf-inet-types {		import ietf-inet-types {
	prefix inet;		prefix inet;
	reference		reference
	"RFC 6991: Common YANG Data Types";		"RFC 6991: Common YANG Data Types";
	}		}
	import ietf-crypto-types {		import ietf-crypto-types {
	prefix ct;		prefix ct;
	reference		reference
	"RFC AAAA: YANG Data Types and Groupings for Cryptography";		"RFC 9640: YANG Data Types and Groupings for Cryptography";
	}		}
	import ietf-tcp-common {		import ietf-tcp-common {
	prefix tcpcmn;		prefix tcpcmn;
	reference		reference
	"RFC DDDD: YANG Groupings for TCP Clients and TCP Servers";		"RFC 9643: YANG Groupings for TCP Clients and TCP Servers";
	}		}
	organization		organization
	"IETF NETCONF (Network Configuration) Working Group and the		"IETF NETCONF (Network Configuration) Working Group and the
	IETF TCP Maintenance and Minor Extensions (TCPM) Working Group";		IETF TCP Maintenance and Minor Extensions (TCPM) Working Group";
	contact		contact
	"WG Web: https://datatracker.ietf.org/wg/netconf		"WG Web: https://datatracker.ietf.org/wg/netconf
	https://datatracker.ietf.org/wg/tcpm		https://datatracker.ietf.org/wg/tcpm
	WG List: NETCONF WG list <mailto:netconf@ietf.org>		WG List: NETCONF WG list <mailto:netconf@ietf.org>
	TCPM WG list <mailto:tcpm@ietf.org>		TCPM WG list <mailto:tcpm@ietf.org>
	Authors: Kent Watsen <mailto:kent+ietf@watsen.net>		Authors: Kent Watsen <mailto:kent+ietf@watsen.net>
	Michael Scharf		Michael Scharf
	<mailto:michael.scharf@hs-esslingen.de>";		<mailto:michael.scharf@hs-esslingen.de>";
	description		description
	"This module defines reusable groupings for TCP clients that		"This module defines reusable groupings for TCP clients that
	can be used as a basis for specific TCP client instances.		can be used as a basis for specific TCP client instances.
	Copyright (c) 2024 IETF Trust and the persons identified		Copyright (c) 2024 IETF Trust and the persons identified
	as authors of the code. All rights reserved.		as authors of the code. All rights reserved.
	Redistribution and use in source and binary forms, with		Redistribution and use in source and binary forms, with
	or without modification, is permitted pursuant to, and		or without modification, is permitted pursuant to, and
	subject to the license terms contained in, the Revised		subject to the license terms contained in, the Revised
	BSD License set forth in Section 4.c of the IETF Trust's		BSD License set forth in Section 4.c of the IETF Trust's
	Legal Provisions Relating to IETF Documents		Legal Provisions Relating to IETF Documents
	(https://trustee.ietf.org/license-info).		(https://trustee.ietf.org/license-info).
	This version of this YANG module is part of RFC DDDD		This version of this YANG module is part of RFC 9643
	(https://www.rfc-editor.org/info/rfcDDDD); see the RFC		(https://www.rfc-editor.org/info/rfc9643); see the RFC
	itself for full legal notices.		itself for full legal notices.";
	The key words 'MUST', 'MUST NOT', 'REQUIRED', 'SHALL',
	'SHALL NOT', 'SHOULD', 'SHOULD NOT', 'RECOMMENDED',
	'NOT RECOMMENDED', 'MAY', and 'OPTIONAL' in this document
	are to be interpreted as described in BCP 14 (RFC 2119)
	(RFC 8174) when, and only when, they appear in all
	capitals, as shown here.";
	revision 2024-04-04 {		revision 2024-04-04 {
	description		description
	"Initial version";		"Initial version.";
	reference		reference
	"RFC DDDD: YANG Groupings for TCP Clients and TCP Servers";		"RFC 9643: YANG Groupings for TCP Clients and TCP Servers";
	}		}
	// Features		// Features
	feature local-binding-supported {		feature local-binding-supported {
	description		description
	"Indicates that the server supports configuring local		"Indicates that the server supports configuring local
	bindings (i.e., the local address and local port) for		bindings (i.e., the local address and local port) for
	TCP clients.";		TCP clients.";
	}		}
	feature tcp-client-keepalives {		feature tcp-client-keepalives {
	description		description
	"Per socket TCP keepalive parameters are configurable for		"TCP keepalive parameters are configurable for
	TCP clients on the server implementing this feature.";		TCP clients on the server implementing this feature.";
	reference		reference
	"RFC 9293: Transmission Control Protocol (TCP)";		"RFC 9293: Transmission Control Protocol (TCP)";
	}		}
	feature proxy-connect {		feature proxy-connect {
	description		description
	"Indicates the TCP-client supports connecting through		"Indicates the TCP client supports connecting through
	TCP proxies.";		TCP proxies.";
	}		}
	feature socks4-supported {		feature socks4-supported {
	if-feature proxy-connect;		if-feature "proxy-connect";
	description		description
	"Indicates the TCP-client supports Socks4-based proxies.";		"Indicates the TCP client supports Socks4-based proxies.";
	reference		reference
	"SOCKS Proceedings:		"SOCKS Proceedings: 1992 Usenix Security Symposium";
	1992 Usenix Security Symposium.";
	}		}
	feature socks4a-supported {		feature socks4a-supported {
	if-feature proxy-connect;		if-feature "proxy-connect";
	description		description
	"Indicates the TCP-client supports Socks4a-based proxies.";		"Indicates the TCP client supports Socks4a-based proxies.";
	reference		reference
	"OpenSSH message:		"OpenSSH message:
	SOCKS 4A: A Simple Extension to SOCKS 4 Protocol		SOCKS 4A: A Simple Extension to SOCKS 4 Protocol
	https://www.openssh.com/txt/socks4a.protocol.";		<https://www.openssh.com/txt/socks4a.protocol>";
	}		}
	feature socks5-supported {		feature socks5-supported {
	if-feature proxy-connect;		if-feature "proxy-connect";
	description		description
	"Indicates the TCP-client supports Socks5-based proxies.";		"Indicates the TCP client supports Socks5-based proxies.";
	reference		reference
	"RFC 1928:		"RFC 1928: SOCKS Protocol Version 5";
	SOCKS Protocol Version 5";
	}		}
	feature socks5-gss-api {		feature socks5-gss-api {
	if-feature socks5-supported;		if-feature "socks5-supported";
	description		description
	"Indicates that the server, when acting as a TCP-client,		"Indicates that the server, when acting as a TCP client,
	supports authenticating to a SOCKS Version 5 proxy server		supports authenticating to a SOCKS Version 5 proxy server
	using GSSAPI credentials.";		using GSS-API credentials.";
	reference		reference
	"RFC 1928: SOCKS Protocol Version 5";		"RFC 1928: SOCKS Protocol Version 5";
	}		}
	feature socks5-username-password {		feature socks5-username-password {
	if-feature socks5-supported;		if-feature "socks5-supported";
	description		description
	"Indicates that the server, when acting as a TCP-client,		"Indicates that the server, when acting as a TCP client,
	supports authenticating to a SOCKS Version 5 proxy server		supports authenticating to a SOCKS Version 5 proxy server
	using 'username' and 'password' credentials.";		using 'username' and 'password' credentials.";
	reference		reference
	"RFC 1928: SOCKS Protocol Version 5";		"RFC 1928: SOCKS Protocol Version 5";
	}		}
	// Groupings		// Groupings
	grouping tcp-client-grouping {		grouping tcp-client-grouping {
	description		description
	skipping to change at page 20, line 18 ¶		skipping to change at line 830 ¶
	establish a connection with. If a domain name is		establish a connection with. If a domain name is
	configured, then the DNS resolution should happen on		configured, then the DNS resolution should happen on
	each connection attempt. If the DNS resolution		each connection attempt. If the DNS resolution
	results in multiple IP addresses, the IP addresses		results in multiple IP addresses, the IP addresses
	are tried according to local preference order until		are tried according to local preference order until
	a connection has been established or until all IP		a connection has been established or until all IP
	addresses have failed.";		addresses have failed.";
	}		}
	leaf remote-port {		leaf remote-port {
	type inet:port-number;		type inet:port-number;
	default "0";
	description		description
	"The IP port number for the remote peer to establish a		"The port number of the remote TCP server.";
	connection with. An invalid default value is used
	so that importing modules may 'refine' it with the
	appropriate default port number value.";
	}		}
	leaf local-address {		leaf local-address {
	if-feature "local-binding-supported";		if-feature "local-binding-supported";
	type inet:ip-address;		type inet:ip-address;
	description		description
	"The local IP address/interface to bind to for when		"The local IP address/interface to bind to for when
	connecting to the remote peer. INADDR_ANY ('0.0.0.0') or		connecting to the remote peer. INADDR_ANY ('0.0.0.0') or
	INADDR6_ANY ('0:0:0:0:0:0:0:0' a.k.a. '::') MAY be used to		INADDR6_ANY ('0:0:0:0:0:0:0:0' a.k.a. '::') MAY be used to
	explicitly indicate the implicit default, that the server		explicitly indicate the implicit default, which the server
	can bind to any IPv4 or IPv6 address.";		can bind to any IPv4 or IPv6 address.";
	}		}
	leaf local-port {		leaf local-port {
	if-feature "local-binding-supported";		if-feature "local-binding-supported";
	type inet:port-number;		type inet:port-number;
	default "0";		default "0";
	description		description
	"The local IP port number to bind to for when connecting		"The local IP port number to bind to for when connecting
	to the remote peer. The port number '0', which is the		to the remote peer. The port number '0', which is the
	default value, indicates that any available local port		default value, indicates that any available local port
	number may be used.";		number may be used.";
	}		}
	container proxy-server {		container proxy-server {
	if-feature "proxy-connect";		if-feature "proxy-connect";
	presence		presence "Indicates that a proxy connection has been
	"Indicates that a proxy connection has been configured.		configured. Present so that the mandatory
	Present so that the mandatory descendant nodes do not		descendant nodes do not imply that this node
	imply that this node must be configured.";		must be configured.";
	choice proxy-type {		choice proxy-type {
	mandatory true;		mandatory true;
	description		description
	"Selects a proxy connection protocol.";		"Selects a proxy connection protocol.";
	case socks4 {		case socks4 {
	if-feature socks4-supported;		if-feature "socks4-supported";
	container socks4-parameters {		container socks4-parameters {
	leaf remote-address {		leaf remote-address {
	type inet:ip-address;		type inet:ip-address;
	mandatory true;		mandatory true;
	description		description
	"The IP address of the proxy server.";		"The IP address of the proxy server.";
	}		}
	leaf remote-port {		leaf remote-port {
	type inet:port-number;		type inet:port-number;
	default "1080";		default "1080";
	description		description
	"The IP port number for the proxy server.";		"The IP port number for the proxy server.";
	}		}
	description		description
	"Parameters for connecting to a TCP-based proxy		"Parameters for connecting to a TCP-based proxy
	server using the SOCKS4 protocol.";		server using the SOCKS4 protocol.";
	reference		reference
	"SOCKS, Proceedings: 1992 Usenix Security Symposium.";		"SOCKS Proceedings: 1992 Usenix Security Symposium";
	}		}
	}		}
	case socks4a {		case socks4a {
	if-feature socks4a-supported;		if-feature "socks4a-supported";
	container socks4a-parameters {		container socks4a-parameters {
	leaf remote-address {		leaf remote-address {
	type inet:host;		type inet:host;
	mandatory true;		mandatory true;
	description		description
	"The IP address or hostname of the proxy server.";		"The IP address or hostname of the proxy server.";
	}		}
	leaf remote-port {		leaf remote-port {
	type inet:port-number;		type inet:port-number;
	default "1080";		default "1080";
	description		description
	"The IP port number for the proxy server.";		"The IP port number for the proxy server.";
	}		}
	description		description
	"Parameters for connecting to a TCP-based proxy		"Parameters for connecting to a TCP-based proxy
	server using the SOCKS4a protocol.";		server using the SOCKS4a protocol.";
	reference		reference
	"SOCKS Proceedings:		"SOCKS Proceedings:
	1992 Usenix Security Symposium.		1992 Usenix Security Symposium
	OpenSSH message:		OpenSSH message:
	SOCKS 4A: A Simple Extension to SOCKS 4 Protocol		SOCKS 4A: A Simple Extension to SOCKS 4 Protocol
	https://www.openssh.com/txt/socks4a.protocol";		<https://www.openssh.com/txt/socks4a.protocol>";
	}		}
	}		}
	case socks5 {		case socks5 {
	if-feature socks5-supported;		if-feature "socks5-supported";
	container socks5-parameters {		container socks5-parameters {
	leaf remote-address {		leaf remote-address {
	type inet:host;		type inet:host;
	mandatory true;		mandatory true;
	description		description
	"The IP address or hostname of the proxy server.";		"The IP address or hostname of the proxy server.";
	}		}
	leaf remote-port {		leaf remote-port {
	type inet:port-number;		type inet:port-number;
	default "1080";		default "1080";
	description		description
	"The IP port number for the proxy server.";		"The IP port number for the proxy server.";
	}		}
	container authentication-parameters {		container authentication-parameters {
	presence		presence "Indicates that an authentication mechanism
	"Indicates that an authentication mechanism		has been configured. Present so that the
	has been configured. Present so that the		mandatory descendant nodes do not imply that
	mandatory descendant nodes do not imply that		this node must be configured.";
	this node must be configured.";
	description		description
	"A container for SOCKS Version 5 authentication		"A container for SOCKS Version 5 authentication
	mechanisms.		mechanisms.
	A complete list of methods is defined at:		A complete list of methods is defined at:
	https://www.iana.org/assignments/socks-methods		<https://www.iana.org/assignments/socks-methods>.";
	/socks-methods.xhtml.";
	reference		reference
	"RFC 1928: SOCKS Protocol Version 5";		"RFC 1928: SOCKS Protocol Version 5";
	choice auth-type {		choice auth-type {
	mandatory true;		mandatory true;
	description		description
	"A choice amongst supported SOCKS Version 5		"A choice amongst supported SOCKS Version 5
	authentication mechanisms.";		authentication mechanisms.";
	case gss-api {		case gss-api {
	if-feature "socks5-gss-api";		if-feature "socks5-gss-api";
	container gss-api {		container gss-api {
	skipping to change at page 23, line 25 ¶		skipping to change at line 975 ¶
	description		description
	"The 'username' value to use for client		"The 'username' value to use for client
	identification.";		identification.";
	}		}
	uses ct:password-grouping {		uses ct:password-grouping {
	description		description
	"The password to be used for client		"The password to be used for client
	authentication.";		authentication.";
	}		}
	description		description
	"Contains Username/Password configuration.";		"Contains username/password configuration.";
	reference		reference
	"RFC 1929: Username/Password Authentication		"RFC 1929: Username/Password Authentication
	for SOCKS V5";		for SOCKS V5";
	}		}
	}		}
	}		}
	}		}
	description		description
	"Parameters for connecting to a TCP-based proxy server		"Parameters for connecting to a TCP-based proxy server
	using the SOCKS5 protocol.";		using the SOCKS5 protocol.";
	skipping to change at page 23, line 49 ¶		skipping to change at line 999 ¶
	}		}
	}		}
	description		description
	"Proxy server settings.";		"Proxy server settings.";
	}		}
	uses tcpcmn:tcp-common-grouping {		uses tcpcmn:tcp-common-grouping {
	refine "keepalives" {		refine "keepalives" {
	if-feature "tcp-client-keepalives";		if-feature "tcp-client-keepalives";
	description		description
	"An if-feature statement so that implementations		"An 'if-feature' statement so that implementations
	can choose to support TCP client keepalives.";		can choose to support TCP client keepalives.";
	}		}
	}		}
	}		}
	}		}
	<CODE ENDS>		<CODE ENDS>
	4. The "ietf-tcp-server" Module		4. The "ietf-tcp-server" Module
	This section defines a YANG 1.1 module called "ietf-tcp-server". A		This section defines a YANG 1.1 module called "ietf-tcp-server". A
	high-level overview of the module is provided in Section 4.1.		high-level overview of the module is provided in Section 4.1.
	Examples illustrating the module's use are provided in Examples		Examples illustrating the module's use are provided in Section 4.2
	(Section 4.2). The YANG module itself is defined in Section 4.3.		("Example Usage"). The YANG module itself is defined in Section 4.3.
	4.1. Data Model Overview		4.1. Data Model Overview
	This section provides an overview of the "ietf-tcp-server" module in		This section provides an overview of the "ietf-tcp-server" module in
	terms of its features and groupings.		terms of its features and groupings.
	4.1.1. Features		4.1.1. Features
	The following diagram lists all the "feature" statements defined in		The following diagram lists all the "feature" statements defined in
	the "ietf-tcp-server" module:		the "ietf-tcp-server" module:
	skipping to change at page 24, line 50 ¶		skipping to change at line 1046 ¶
	This grouping is presented in the following subsection.		This grouping is presented in the following subsection.
	4.1.2.1. The "tcp-server-grouping" Grouping		4.1.2.1. The "tcp-server-grouping" Grouping
	The following tree diagram [RFC8340] illustrates the "tcp-server-		The following tree diagram [RFC8340] illustrates the "tcp-server-
	grouping" grouping:		grouping" grouping:
	grouping tcp-server-grouping:		grouping tcp-server-grouping:
	+-- local-bind* [local-address]		+-- local-bind* [local-address]
	| +-- local-address? inet:ip-address		| +-- local-address inet:ip-address
	| +-- local-port? inet:port-number		| +-- local-port? inet:port-number
	+---u tcpcmn:tcp-common-grouping		+---u tcpcmn:tcp-common-grouping
	Comments:		Comments:
	* The "local-address" node, which is mandatory, may be configured as		* The "local-address" node, which is mandatory, may be configured as
	an IPv4 address, an IPv6 address, or a wildcard value.		an IPv4 address, an IPv6 address, or a wildcard value.
	* The "local-port" node is not mandatory, but its default value is		* The "local-port" leaf is defined with neither a "default" nor a
	the invalid value '0', thus forcing the consuming data model to		"mandatory" statement. YANG modules using this grouping SHOULD
	refine it in order to provide it an appropriate default value.		refine the grouping with a "default" statement, when the port
			number is well-known (e.g., a port number allocated by IANA), or
			with a "mandatory" statement, if a port number needs to always be
			configured. The SHOULD can be ignored when the port number is
			neither well-known nor mandatory to configure, such as might be
			the case when this grouping is used by another grouping.
	* This grouping uses the "tcp-common-grouping" grouping discussed in		* This grouping uses the "tcp-common-grouping" grouping discussed in
	Section 2.1.3.1.		Section 2.1.3.1.
	4.1.3. Protocol-accessible Nodes		4.1.3. Protocol-Accessible Nodes
	The "ietf-tcp-server" module defines only "grouping" statements that		The "ietf-tcp-server" module defines only "grouping" statements that
	are used by other modules to instantiate protocol-accessible nodes.		are used by other modules to instantiate protocol-accessible nodes.
	Thus this module, when implemented, does not itself define any		Thus, this module, when implemented, does not itself define any
	protocol-accessible nodes.		protocol-accessible nodes.
	4.2. Example Usage		4.2. Example Usage
	This section presents an example showing the "tcp-server-grouping"		This section presents an example showing the "tcp-server-grouping"
	populated with some data.		grouping populated with some data.
	<!-- The outermost element below doesn't exist in the data model. -->		<!-- The outermost element below doesn't exist in the data model. -->
	<!-- It simulates if the "grouping" were a "container" instead. -->		<!-- It simulates if the "grouping" were a "container" instead. -->
	<tcp-server xmlns="urn:ietf:params:xml:ns:yang:ietf-tcp-server">		<tcp-server xmlns="urn:ietf:params:xml:ns:yang:ietf-tcp-server">
	<local-bind>		<local-bind>
	<local-address>192.0.2.2</local-address>		<local-address>192.0.2.2</local-address>
	<local-port>49152</local-port>		<local-port>49152</local-port>
	</local-bind>		</local-bind>
	<keepalives>		<keepalives>
	<idle-time>7200</idle-time>		<idle-time>7200</idle-time>
	<max-probes>9</max-probes>		<max-probes>9</max-probes>
	<probe-interval>75</probe-interval>		<probe-interval>75</probe-interval>
	</keepalives>		</keepalives>
	</tcp-server>		</tcp-server>
	4.3. YANG Module		4.3. YANG Module
	The ietf-tcp-server YANG module references [RFC6991] and [RFC9293].		The "ietf-tcp-server" YANG module references [RFC6991] and [RFC9293].
	<CODE BEGINS> file "ietf-tcp-server@2024-04-04.yang"		<CODE BEGINS> file "ietf-tcp-server@2024-04-04.yang"
	module ietf-tcp-server {		module ietf-tcp-server {
	yang-version 1.1;		yang-version 1.1;
	namespace "urn:ietf:params:xml:ns:yang:ietf-tcp-server";		namespace "urn:ietf:params:xml:ns:yang:ietf-tcp-server";
	prefix tcps;		prefix tcps;
	import ietf-inet-types {		import ietf-inet-types {
	prefix inet;		prefix inet;
	reference		reference
	"RFC 6991: Common YANG Data Types";		"RFC 6991: Common YANG Data Types";
	}		}
	import ietf-tcp-common {		import ietf-tcp-common {
	prefix tcpcmn;		prefix tcpcmn;
	reference		reference
	"RFC DDDD: YANG Groupings for TCP Clients and TCP Servers";		"RFC 9643: YANG Groupings for TCP Clients and TCP Servers";
	}		}
	organization		organization
	"IETF NETCONF (Network Configuration) Working Group and the		"IETF NETCONF (Network Configuration) Working Group and the
	IETF TCP Maintenance and Minor Extensions (TCPM) Working Group";		IETF TCP Maintenance and Minor Extensions (TCPM) Working Group";
	contact		contact
	"WG Web: https://datatracker.ietf.org/wg/netconf		"WG Web: https://datatracker.ietf.org/wg/netconf
	https://datatracker.ietf.org/wg/tcpm		https://datatracker.ietf.org/wg/tcpm
	WG List: NETCONF WG list <mailto:netconf@ietf.org>		WG List: NETCONF WG list <mailto:netconf@ietf.org>
	TCPM WG list <mailto:tcpm@ietf.org>		TCPM WG list <mailto:tcpm@ietf.org>
	Authors: Kent Watsen <mailto:kent+ietf@watsen.net>		Authors: Kent Watsen <mailto:kent+ietf@watsen.net>
	Michael Scharf		Michael Scharf
	<mailto:michael.scharf@hs-esslingen.de>";		<mailto:michael.scharf@hs-esslingen.de>";
	description		description
	"This module defines reusable groupings for TCP servers that		"This module defines reusable groupings for TCP servers that
	can be used as a basis for specific TCP server instances.		can be used as a basis for specific TCP server instances.
	Copyright (c) 2024 IETF Trust and the persons identified		Copyright (c) 2024 IETF Trust and the persons identified
	as authors of the code. All rights reserved.		as authors of the code. All rights reserved.
	Redistribution and use in source and binary forms, with		Redistribution and use in source and binary forms, with
	or without modification, is permitted pursuant to, and		or without modification, is permitted pursuant to, and
	subject to the license terms contained in, the Revised		subject to the license terms contained in, the Revised
	BSD License set forth in Section 4.c of the IETF Trust's		BSD License set forth in Section 4.c of the IETF Trust's
	Legal Provisions Relating to IETF Documents		Legal Provisions Relating to IETF Documents
	(https://trustee.ietf.org/license-info).		(https://trustee.ietf.org/license-info).
	This version of this YANG module is part of RFC DDDD		This version of this YANG module is part of RFC 9643
	(https://www.rfc-editor.org/info/rfcDDDD); see the RFC		(https://www.rfc-editor.org/info/rfc9643); see the RFC
	itself for full legal notices.		itself for full legal notices.";
	The key words 'MUST', 'MUST NOT', 'REQUIRED', 'SHALL',
	'SHALL NOT', 'SHOULD', 'SHOULD NOT', 'RECOMMENDED',
	'NOT RECOMMENDED', 'MAY', and 'OPTIONAL' in this document
	are to be interpreted as described in BCP 14 (RFC 2119)
	(RFC 8174) when, and only when, they appear in all
	capitals, as shown here.";
	revision 2024-04-04 {		revision 2024-04-04 {
	description		description
	"Initial version";		"Initial version.";
	reference		reference
	"RFC DDDD: YANG Groupings for TCP Clients and TCP Servers";		"RFC 9643: YANG Groupings for TCP Clients and TCP Servers";
	}		}
	// Features		// Features
	feature tcp-server-keepalives {		feature tcp-server-keepalives {
	description		description
	"Per socket TCP keepalive parameters are configurable for		"TCP keepalive parameters are configurable for
	TCP servers on the server implementing this feature.";		TCP servers on the server implementing this feature.";
	reference		reference
	"RFC 9293: Transmission Control Protocol (TCP)";		"RFC 9293: Transmission Control Protocol (TCP)";
	}		}
	// Groupings		// Groupings
	grouping tcp-server-grouping {		grouping tcp-server-grouping {
	description		description
	"A reusable grouping for configuring a TCP server.		"A reusable grouping for configuring a TCP server.
	Note that this grouping uses fairly typical descendant		Note that this grouping uses fairly typical descendant
	node names such that a stack of 'uses' statements will		node names such that a stack of 'uses' statements will
	have name conflicts. It is intended that the consuming		have name conflicts. It is intended that the consuming
	data model will resolve the issue (e.g., by wrapping		data model will resolve the issue (e.g., by wrapping
	the 'uses' statement in a container called		the 'uses' statement in a container called
	'tcp-server-parameters'). This model purposely does		'tcp-server-parameters'). This model purposely does
	not do this itself so as to provide maximum flexibility		not do this itself so as to provide maximum flexibility
	to consuming models.";		to consuming models.";
	list local-bind {		list local-bind {
	key local-address;		key "local-address";
	min-elements 1;		min-elements 1;
	description		description
	"A list of bind (listen) points for this server		"A list of bind (listen) points for this server
	instance. A server instance may have multiple		instance. A server instance may have multiple
	bind points to support, e.g., the same port in		bind points to support, e.g., the same port in
	different address families or different ports		different address families or different ports
	in the same address family.";		in the same address family.";
	leaf local-address {		leaf local-address {
	type inet:ip-address;		type inet:ip-address;
	description		description
	"The local IP address to listen on for incoming		"The local IP address to listen on for incoming
	TCP client connections. To configure listening		TCP client connections. To configure listening
	on all IPv4 addresses the value must be '0.0.0.0'		on all IPv4 addresses, the value must be '0.0.0.0'
	(INADDR_ANY). To configure listening on all IPv6		(INADDR_ANY). To configure listening on all IPv6
	addresses the value must be '::' (INADDR6_ANY).";		addresses, the value must be '::' (INADDR6_ANY).";
	}		}
	leaf local-port {		leaf local-port {
	type inet:port-number;		type inet:port-number;
	default "0";
	description		description
	"The local port number to listen on for incoming TCP		"The local port number to listen on for incoming TCP
	client connections. An invalid default value (0)		client connections.";
	is used (instead of 'mandatory true') so that an
	application level data model may 'refine' it with
	an application specific default port number value.";
	}		}
	}		}
	uses tcpcmn:tcp-common-grouping {		uses tcpcmn:tcp-common-grouping {
	refine "keepalives" {		refine "keepalives" {
	if-feature "tcp-server-keepalives";		if-feature "tcp-server-keepalives";
	description		description
	"An if-feature statement so that implementations		"An 'if-feature' statement so that implementations
	can choose to support TCP server keepalives.";		can choose to support TCP server keepalives.";
	}		}
	}		}
	}		}
	}		}
	<CODE ENDS>		<CODE ENDS>
	5. Security Considerations		5. Security Considerations
	The three YANG modules in this document define groupings and will not		The three YANG modules in this document define groupings and will not
	be deployed as standalone modules. Their security implications may		be deployed as standalone modules. Their security implications may
	be context dependent based on their use in other modules. The		be context-dependent based on their use in other modules. The
	designers of modules which import these grouping must conduct their		designers of modules that import these groupings must conduct their
	own analysis of the security considerations.		own analysis of the security considerations.
	5.1. Considerations for the "ietf-tcp-common" YANG Module		5.1. Considerations for the "ietf-tcp-common" YANG Module
	This section follows the template defined in Section 3.7.1 of		This section is modeled after the template defined in Section 3.7.1
	[RFC8407].		of [RFC8407].
	The "ietf-tcp-common" YANG module defines "grouping" statements that		The "ietf-tcp-common" YANG module defines "grouping" statements that
	are designed to be accessed via YANG based management protocols, such		are designed to be accessed via YANG-based management protocols, such
	as NETCONF [RFC6241] and RESTCONF [RFC8040]. Both of these protocols		as NETCONF [RFC6241] and RESTCONF [RFC8040]. Both of these protocols
	have mandatory-to-implement secure transport layers (e.g., SSH, TLS)		have mandatory-to-implement secure transport layers (e.g., Secure
	with mutual authentication.		Shell (SSH) [RFC4252], TLS [RFC8446], and QUIC [RFC9000]) and
			mandatory-to-implement mutual authentication.
	The Network Access Control Model (NACM) [RFC8341] provides the means		The Network Configuration Access Control Model (NACM) [RFC8341]
	to restrict access for particular users to a pre-configured subset of		provides the means to restrict access for particular users to a
	all available protocol operations and content.		preconfigured subset of all available protocol operations and
			content.
	Please be aware that this YANG module uses groupings from other YANG		Please be aware that this YANG module uses groupings from other YANG
	modules that define nodes that may be considered sensitive or		modules that define nodes that may be considered sensitive or
	vulnerable in network environments. Please review the Security		vulnerable in network environments. Please review the security
	Considerations for dependent YANG modules for information as to which		considerations for dependent YANG modules for information as to which
	nodes may be considered sensitive or vulnerable in network		nodes may be considered sensitive or vulnerable in network
	environments.		environments.
	None of the readable data nodes defined in this YANG module are		None of the readable data nodes defined in this YANG module are
	considered sensitive or vulnerable in network environments. The NACM		considered sensitive or vulnerable in network environments. The NACM
	"default-deny-all" extension has not been set for any data nodes		"default-deny-all" extension has not been set for any data nodes
	defined in this module.		defined in this module.
	None of the writable data nodes defined in this YANG module are		None of the writable data nodes defined in this YANG module are
	considered sensitive or vulnerable in network environments. The NACM		considered sensitive or vulnerable in network environments. The NACM
	"default-deny-write" extension has not been set for any data nodes		"default-deny-write" extension has not been set for any data nodes
	defined in this module.		defined in this module.
	This module does not define any RPCs, actions, or notifications, and		This module does not define any RPCs, actions, or notifications, and
	thus the security consideration for such is not provided here.		thus, the security considerations for such are not provided here.
	5.2. Considerations for the "ietf-tcp-client" YANG Module		5.2. Considerations for the "ietf-tcp-client" YANG Module
	This section follows the template defined in Section 3.7.1 of		This section is modeled after the template defined in Section 3.7.1
	[RFC8407].		of [RFC8407].
	The "ietf-tcp-client" YANG module defines "grouping" statements that		The "ietf-tcp-client" YANG module defines "grouping" statements that
	are designed to be accessed via YANG based management protocols, such		are designed to be accessed via YANG-based management protocols, such
	as NETCONF [RFC6241] and RESTCONF [RFC8040]. Both of these protocols		as NETCONF [RFC6241] and RESTCONF [RFC8040]. Both of these protocols
	have mandatory-to-implement secure transport layers (e.g., SSH, TLS)		have mandatory-to-implement secure transport layers (e.g., Secure
	with mutual authentication.		Shell (SSH) [RFC4252], TLS [RFC8446], and QUIC [RFC9000]) and
			mandatory-to-implement mutual authentication.
	The Network Access Control Model (NACM) [RFC8341] provides the means		The Network Configuration Access Control Model (NACM) [RFC8341]
	to restrict access for particular users to a pre-configured subset of		provides the means to restrict access for particular users to a
	all available protocol operations and content.		preconfigured subset of all available protocol operations and
			content.
	Please be aware that this YANG module uses groupings from other YANG		Please be aware that this YANG module uses groupings from other YANG
	modules that define nodes that may be considered sensitive or		modules that define nodes that may be considered sensitive or
	vulnerable in network environments. Please review the Security		vulnerable in network environments. Please review the security
	Considerations for dependent YANG modules for information as to which		considerations for dependent YANG modules for information as to which
	nodes may be considered sensitive or vulnerable in network		nodes may be considered sensitive or vulnerable in network
	environments.		environments.
	One readable data node defined in this YANG module may be considered		One readable data node defined in this YANG module may be considered
	sensitive or vulnerable in some network environments. This node is		sensitive or vulnerable in some network environments. This node is
	as follows:		as follows:
	* The "proxy-server/socks5-parameters/authentication-parameters/		* The "proxy-server/socks5-parameters/authentication-parameters/
	username-password/password" node:		username-password/password" node:
	The "password" node defined in the "tcp-client-grouping"		The "password" node defined in the "tcp-client-grouping"
	grouping is defined using the "password-grouping" grouping		grouping is defined using the "password-grouping" grouping
	presented in [I-D.ietf-netconf-crypto-types]. This grouping		presented in [RFC9640]. This grouping enables both cleartext
	enables both cleartext and encrypted passwords to be		and encrypted passwords to be configured. As the referenced
	configured. As the referenced document states, configuration		document states, configuration of cleartext passwords is NOT
	of cleartext passwords is NOT RECOMMENDED. However, in the		RECOMMENDED. However, in the case cleartext values are
	case cleartext values are configured, this node is additionally		configured, this node is additionally sensitive to read
	sensitive to read operations such that, in normal use cases, it		operations such that, in normal use cases, it should never be
	should never be returned to a client. For this reason, the		returned to a client. For this reason, the NACM "default-deny-
	NACM extension "default-deny-all" has been applied to it.		all" extension has been applied to it.
	None of the writable data nodes defined in this YANG module are		None of the writable data nodes defined in this YANG module are
	considered sensitive or vulnerable in network environments. The NACM		considered sensitive or vulnerable in network environments. The NACM
	"default-deny-write" extension has not been set for any data nodes		"default-deny-write" extension has not been set for any data nodes
	defined in this module.		defined in this module.
	This module does not define any RPCs, actions, or notifications, and		This module does not define any RPCs, actions, or notifications, and
	thus the security consideration for such is not provided here.		thus, the security considerations for such are not provided here.
	Implementations are RECOMMENDED to implement the "local-binding-		Implementations are RECOMMENDED to implement the "local-binding-
	supported" feature for cryptographically-secure protocols, so as to		supported" feature for cryptographically secure protocols so as to
	enable more granular ingress/egress firewall rulebases. It is NOT		enable more granular ingress/egress firewall rule bases. It is NOT
	RECOMMENDED to implement this feature for unsecure protocols, as per		RECOMMENDED to implement this feature for unsecure protocols, as per
	[RFC6056].		[RFC6056].
	5.3. Considerations for the "ietf-tcp-server" YANG Module		5.3. Considerations for the "ietf-tcp-server" YANG Module
	This section follows the template defined in Section 3.7.1 of		This section is modeled after the template defined in Section 3.7.1
	[RFC8407].		of [RFC8407].
	The "ietf-tcp-server" YANG module defines "grouping" statements that		The "ietf-tcp-server" YANG module defines "grouping" statements that
	are designed to be accessed via YANG based management protocols, such		are designed to be accessed via YANG-based management protocols, such
	as NETCONF [RFC6241] and RESTCONF [RFC8040]. Both of these protocols		as NETCONF [RFC6241] and RESTCONF [RFC8040]. Both of these protocols
	have mandatory-to-implement secure transport layers (e.g., SSH, TLS)		have mandatory-to-implement secure transport layers (e.g., Secure
	with mutual authentication.		Shell (SSH) [RFC4252], TLS [RFC8446], and QUIC [RFC9000]) and
			mandatory-to-implement mutual authentication.
	The Network Access Control Model (NACM) [RFC8341] provides the means		The Network Configuration Access Control Model (NACM) [RFC8341]
	to restrict access for particular users to a pre-configured subset of		provides the means to restrict access for particular users to a
	all available protocol operations and content.		preconfigured subset of all available protocol operations and
			content.
	Please be aware that this YANG module uses groupings from other YANG		Please be aware that this YANG module uses groupings from other YANG
	modules that define nodes that may be considered sensitive or		modules that define nodes that may be considered sensitive or
	vulnerable in network environments. Please review the Security		vulnerable in network environments. Please review the security
	Considerations for dependent YANG modules for information as to which		considerations for dependent YANG modules for information as to which
	nodes may be considered sensitive or vulnerable in network		nodes may be considered sensitive or vulnerable in network
	environments.		environments.
	None of the readable data nodes defined in this YANG module are		None of the readable data nodes defined in this YANG module are
	considered sensitive or vulnerable in network environments. The NACM		considered sensitive or vulnerable in network environments. The NACM
	"default-deny-all" extension has not been set for any data nodes		"default-deny-all" extension has not been set for any data nodes
	defined in this module.		defined in this module.
	None of the writable data nodes defined in this YANG module are		None of the writable data nodes defined in this YANG module are
	considered sensitive or vulnerable in network environments. The NACM		considered sensitive or vulnerable in network environments. The NACM
	"default-deny-write" extension has not been set for any data nodes		"default-deny-write" extension has not been set for any data nodes
	defined in this module.		defined in this module.
	This module does not define any RPCs, actions, or notifications, and		This module does not define any RPCs, actions, or notifications, and
	thus the security consideration for such is not provided here.		thus, the security considerations for such are not provided here.
	6. IANA Considerations		6. IANA Considerations
	6.1. The "IETF XML" Registry		6.1. The IETF XML Registry
	This document registers three URIs in the "ns" subregistry of the		IANA has registered the following URI in the "ns" registry of the
	IETF XML Registry [RFC3688]. Following the format in [RFC3688], the		"IETF XML Registry" [RFC3688].
	following registrations are requested:
	URI: urn:ietf:params:xml:ns:yang:ietf-tcp-common		URI: urn:ietf:params:xml:ns:yang:ietf-tcp-common
	Registrant Contact: The IESG		Registrant Contact: The IESG
	XML: N/A, the requested URI is an XML namespace.		XML: N/A; the requested URI is an XML namespace.
	URI: urn:ietf:params:xml:ns:yang:ietf-tcp-client		URI: urn:ietf:params:xml:ns:yang:ietf-tcp-client
	Registrant Contact: The IESG		Registrant Contact: The IESG
	XML: N/A, the requested URI is an XML namespace.		XML: N/A; the requested URI is an XML namespace.
	URI: urn:ietf:params:xml:ns:yang:ietf-tcp-server		URI: urn:ietf:params:xml:ns:yang:ietf-tcp-server
	Registrant Contact: The IESG		Registrant Contact: The IESG
	XML: N/A, the requested URI is an XML namespace.		XML: N/A; the requested URI is an XML namespace.
	6.2. The "YANG Module Names" Registry		6.2. The YANG Module Names Registry
	This document registers three YANG modules in the YANG Module Names		IANA has registered the following three YANG modules in the "YANG
	registry [RFC6020]. Following the format in [RFC6020], the following		Module Names" registry [RFC6020].
	registrations are requested:
	name: ietf-tcp-common		Name: ietf-tcp-common
	namespace: urn:ietf:params:xml:ns:yang:ietf-tcp-common		Namespace: urn:ietf:params:xml:ns:yang:ietf-tcp-common
	prefix: tcpcmn		Prefix: tcpcmn
	reference: RFC DDDD		Reference: RFC 9643
	name: ietf-tcp-client		Name: ietf-tcp-client
	namespace: urn:ietf:params:xml:ns:yang:ietf-tcp-client		Namespace: urn:ietf:params:xml:ns:yang:ietf-tcp-client
	prefix: tcpc		Prefix: tcpc
	reference: RFC DDDD		Reference: RFC 9643
	name: ietf-tcp-server		Name: ietf-tcp-server
	namespace: urn:ietf:params:xml:ns:yang:ietf-tcp-server		Namespace: urn:ietf:params:xml:ns:yang:ietf-tcp-server
	prefix: tcps		Prefix: tcps
	reference: RFC DDDD		Reference: RFC 9643
	7. References		7. References
	7.1. Normative References		7.1. Normative References
	[I-D.ietf-netconf-crypto-types]
	Watsen, K., "YANG Data Types and Groupings for
	Cryptography", Work in Progress, Internet-Draft, draft-
	ietf-netconf-crypto-types-34, 16 March 2024,
	<https://datatracker.ietf.org/doc/html/draft-ietf-netconf-
	crypto-types-34>.
	[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate		[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
	Requirement Levels", BCP 14, RFC 2119,		Requirement Levels", BCP 14, RFC 2119,
	DOI 10.17487/RFC2119, March 1997,		DOI 10.17487/RFC2119, March 1997,
	<https://www.rfc-editor.org/info/rfc2119>.		<https://www.rfc-editor.org/info/rfc2119>.
			[RFC4252] Ylonen, T. and C. Lonvick, Ed., "The Secure Shell (SSH)
			Authentication Protocol", RFC 4252, DOI 10.17487/RFC4252,
			January 2006, <https://www.rfc-editor.org/info/rfc4252>.
	[RFC6020] Bjorklund, M., Ed., "YANG - A Data Modeling Language for		[RFC6020] Bjorklund, M., Ed., "YANG - A Data Modeling Language for
	the Network Configuration Protocol (NETCONF)", RFC 6020,		the Network Configuration Protocol (NETCONF)", RFC 6020,
	DOI 10.17487/RFC6020, October 2010,		DOI 10.17487/RFC6020, October 2010,
	<https://www.rfc-editor.org/info/rfc6020>.		<https://www.rfc-editor.org/info/rfc6020>.
	[RFC6991] Schoenwaelder, J., Ed., "Common YANG Data Types",		[RFC6991] Schoenwaelder, J., Ed., "Common YANG Data Types",
	RFC 6991, DOI 10.17487/RFC6991, July 2013,		RFC 6991, DOI 10.17487/RFC6991, July 2013,
	<https://www.rfc-editor.org/info/rfc6991>.		<https://www.rfc-editor.org/info/rfc6991>.
	[RFC7950] Bjorklund, M., Ed., "The YANG 1.1 Data Modeling Language",		[RFC7950] Bjorklund, M., Ed., "The YANG 1.1 Data Modeling Language",
	skipping to change at page 33, line 18 ¶		skipping to change at line 1427 ¶
	[RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC		[RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC
	2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174,		2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174,
	May 2017, <https://www.rfc-editor.org/info/rfc8174>.		May 2017, <https://www.rfc-editor.org/info/rfc8174>.
	[RFC8341] Bierman, A. and M. Bjorklund, "Network Configuration		[RFC8341] Bierman, A. and M. Bjorklund, "Network Configuration
	Access Control Model", STD 91, RFC 8341,		Access Control Model", STD 91, RFC 8341,
	DOI 10.17487/RFC8341, March 2018,		DOI 10.17487/RFC8341, March 2018,
	<https://www.rfc-editor.org/info/rfc8341>.		<https://www.rfc-editor.org/info/rfc8341>.
			[RFC9000] Iyengar, J., Ed. and M. Thomson, Ed., "QUIC: A UDP-Based
			Multiplexed and Secure Transport", RFC 9000,
			DOI 10.17487/RFC9000, May 2021,
			<https://www.rfc-editor.org/info/rfc9000>.
	[RFC9293] Eddy, W., Ed., "Transmission Control Protocol (TCP)",		[RFC9293] Eddy, W., Ed., "Transmission Control Protocol (TCP)",
	STD 7, RFC 9293, DOI 10.17487/RFC9293, August 2022,		STD 7, RFC 9293, DOI 10.17487/RFC9293, August 2022,
	<https://www.rfc-editor.org/info/rfc9293>.		<https://www.rfc-editor.org/info/rfc9293>.
			[RFC9640] Watsen, K., "YANG Data Types and Groupings for
			Cryptography", RFC 9640, DOI 10.17487/RFC9640, October
			2024, <https://www.rfc-editor.org/info/rfc9640>.
	7.2. Informative References		7.2. Informative References
	[I-D.ietf-netconf-http-client-server]		[HTTP-CLIENT-SERVER]
	Watsen, K., "YANG Groupings for HTTP Clients and HTTP		Watsen, K., "YANG Groupings for HTTP Clients and HTTP
	Servers", Work in Progress, Internet-Draft, draft-ietf-		Servers", Work in Progress, Internet-Draft, draft-ietf-
	netconf-http-client-server-20, 16 March 2024,		netconf-http-client-server-23, 15 August 2024,
	<https://datatracker.ietf.org/doc/html/draft-ietf-netconf-
	http-client-server-20>.
	[I-D.ietf-netconf-keystore]
	Watsen, K., "A YANG Data Model for a Keystore and Keystore
	Operations", Work in Progress, Internet-Draft, draft-ietf-
	netconf-keystore-35, 16 March 2024,
	<https://datatracker.ietf.org/doc/html/draft-ietf-netconf-		<https://datatracker.ietf.org/doc/html/draft-ietf-netconf-
	keystore-35>.		http-client-server-23>.
	[I-D.ietf-netconf-netconf-client-server]		[NETCONF-CLIENT-SERVER]
	Watsen, K., "NETCONF Client and Server Models", Work in		Watsen, K., "NETCONF Client and Server Models", Work in
	Progress, Internet-Draft, draft-ietf-netconf-netconf-		Progress, Internet-Draft, draft-ietf-netconf-netconf-
	client-server-36, 16 March 2024,		client-server-37, 14 August 2024,
	<https://datatracker.ietf.org/doc/html/draft-ietf-netconf-		<https://datatracker.ietf.org/doc/html/draft-ietf-netconf-
	netconf-client-server-36>.		netconf-client-server-37>.
	[I-D.ietf-netconf-restconf-client-server]		[RESTCONF-CLIENT-SERVER]
	Watsen, K., "RESTCONF Client and Server Models", Work in		Watsen, K., "RESTCONF Client and Server Models", Work in
	Progress, Internet-Draft, draft-ietf-netconf-restconf-		Progress, Internet-Draft, draft-ietf-netconf-restconf-
	client-server-36, 16 March 2024,		client-server-38, 14 August 2024,
	<https://datatracker.ietf.org/doc/html/draft-ietf-netconf-
	restconf-client-server-36>.
	[I-D.ietf-netconf-ssh-client-server]
	Watsen, K., "YANG Groupings for SSH Clients and SSH
	Servers", Work in Progress, Internet-Draft, draft-ietf-
	netconf-ssh-client-server-40, 16 March 2024,
	<https://datatracker.ietf.org/doc/html/draft-ietf-netconf-
	ssh-client-server-40>.
	[I-D.ietf-netconf-tcp-client-server]
	Watsen, K. and M. Scharf, "YANG Groupings for TCP Clients
	and TCP Servers", Work in Progress, Internet-Draft, draft-
	ietf-netconf-tcp-client-server-26, 4 April 2024,
	<https://datatracker.ietf.org/doc/html/draft-ietf-netconf-
	tcp-client-server-26>.
	[I-D.ietf-netconf-tls-client-server]
	Watsen, K., "YANG Groupings for TLS Clients and TLS
	Servers", Work in Progress, Internet-Draft, draft-ietf-
	netconf-tls-client-server-41, 16 March 2024,
	<https://datatracker.ietf.org/doc/html/draft-ietf-netconf-
	tls-client-server-41>.
	[I-D.ietf-netconf-trust-anchors]
	Watsen, K., "A YANG Data Model for a Truststore", Work in
	Progress, Internet-Draft, draft-ietf-netconf-trust-
	anchors-28, 16 March 2024,
	<https://datatracker.ietf.org/doc/html/draft-ietf-netconf-		<https://datatracker.ietf.org/doc/html/draft-ietf-netconf-
	trust-anchors-28>.		restconf-client-server-38>.
	[RFC1928] Leech, M., Ganis, M., Lee, Y., Kuris, R., Koblas, D., and		[RFC1928] Leech, M., Ganis, M., Lee, Y., Kuris, R., Koblas, D., and
	L. Jones, "SOCKS Protocol Version 5", RFC 1928,		L. Jones, "SOCKS Protocol Version 5", RFC 1928,
	DOI 10.17487/RFC1928, March 1996,		DOI 10.17487/RFC1928, March 1996,
	<https://www.rfc-editor.org/info/rfc1928>.		<https://www.rfc-editor.org/info/rfc1928>.
	[RFC1929] Leech, M., "Username/Password Authentication for SOCKS		[RFC1929] Leech, M., "Username/Password Authentication for SOCKS
	V5", RFC 1929, DOI 10.17487/RFC1929, March 1996,		V5", RFC 1929, DOI 10.17487/RFC1929, March 1996,
	<https://www.rfc-editor.org/info/rfc1929>.		<https://www.rfc-editor.org/info/rfc1929>.
	skipping to change at page 35, line 19 ¶		skipping to change at line 1495 ¶
	[RFC6241] Enns, R., Ed., Bjorklund, M., Ed., Schoenwaelder, J., Ed.,		[RFC6241] Enns, R., Ed., Bjorklund, M., Ed., Schoenwaelder, J., Ed.,
	and A. Bierman, Ed., "Network Configuration Protocol		and A. Bierman, Ed., "Network Configuration Protocol
	(NETCONF)", RFC 6241, DOI 10.17487/RFC6241, June 2011,		(NETCONF)", RFC 6241, DOI 10.17487/RFC6241, June 2011,
	<https://www.rfc-editor.org/info/rfc6241>.		<https://www.rfc-editor.org/info/rfc6241>.
	[RFC8040] Bierman, A., Bjorklund, M., and K. Watsen, "RESTCONF		[RFC8040] Bierman, A., Bjorklund, M., and K. Watsen, "RESTCONF
	Protocol", RFC 8040, DOI 10.17487/RFC8040, January 2017,		Protocol", RFC 8040, DOI 10.17487/RFC8040, January 2017,
	<https://www.rfc-editor.org/info/rfc8040>.		<https://www.rfc-editor.org/info/rfc8040>.
			[RFC8259] Bray, T., Ed., "The JavaScript Object Notation (JSON) Data
			Interchange Format", STD 90, RFC 8259,
			DOI 10.17487/RFC8259, December 2017,
			<https://www.rfc-editor.org/info/rfc8259>.
	[RFC8340] Bjorklund, M. and L. Berger, Ed., "YANG Tree Diagrams",		[RFC8340] Bjorklund, M. and L. Berger, Ed., "YANG Tree Diagrams",
	BCP 215, RFC 8340, DOI 10.17487/RFC8340, March 2018,		BCP 215, RFC 8340, DOI 10.17487/RFC8340, March 2018,
	<https://www.rfc-editor.org/info/rfc8340>.		<https://www.rfc-editor.org/info/rfc8340>.
	[RFC8342] Bjorklund, M., Schoenwaelder, J., Shafer, P., Watsen, K.,		[RFC8342] Bjorklund, M., Schoenwaelder, J., Shafer, P., Watsen, K.,
	and R. Wilton, "Network Management Datastore Architecture		and R. Wilton, "Network Management Datastore Architecture
	(NMDA)", RFC 8342, DOI 10.17487/RFC8342, March 2018,		(NMDA)", RFC 8342, DOI 10.17487/RFC8342, March 2018,
	<https://www.rfc-editor.org/info/rfc8342>.		<https://www.rfc-editor.org/info/rfc8342>.
	[RFC8407] Bierman, A., "Guidelines for Authors and Reviewers of		[RFC8407] Bierman, A., "Guidelines for Authors and Reviewers of
	Documents Containing YANG Data Models", BCP 216, RFC 8407,		Documents Containing YANG Data Models", BCP 216, RFC 8407,
	DOI 10.17487/RFC8407, October 2018,		DOI 10.17487/RFC8407, October 2018,
	<https://www.rfc-editor.org/info/rfc8407>.		<https://www.rfc-editor.org/info/rfc8407>.
	[SOCKS_4A] Project, T. O., "SOCKS 4A: A Simple Extension to SOCKS 4		[RFC8446] Rescorla, E., "The Transport Layer Security (TLS) Protocol
	Protocol", <https://www.openssh.com/txt/socks4a.protocol>.		Version 1.3", RFC 8446, DOI 10.17487/RFC8446, August 2018,
			<https://www.rfc-editor.org/info/rfc8446>.
	Appendix A. Change Log
	A.1. 00 to 01
	* Added 'local-binding-supported' feature to TCP-client model.
	* Added 'keepalives-supported' feature to TCP-common model.
	* Added 'external-endpoint-values' container and 'external-
	endpoints' feature to TCP-server model.
	A.2. 01 to 02
	* Removed the 'external-endpoint-values' container and 'external-
	endpoints' feature from the TCP-server model.
	A.3. 02 to 03
	* Moved the common model section to be before the client and server
	specific sections.
	* Added sections "Model Scope" and "Usage Guidelines for Configuring
	TCP Keep-Alives" to the common model section.
	A.4. 03 to 04
	* Fixed a few typos.
	A.5. 04 to 05
	* Removed commented out "grouping tcp-system-grouping" statement
	kept for reviewers.
	* Added a "Note to Reviewers" note to first page.
	A.6. 05 to 06
	* Added support for TCP proxies.
	A.7. 06 to 07
	* Expanded "Data Model Overview section(s) [remove "wall" of tree
	diagrams].
	* Updated the Security Considerations section.
	A.8. 07 to 08
	* Added missing IANA registration for "ietf-tcp-common"
	* Added "mandatory true" for the "username" and "password" leafs
	* Added an example of a TCP-client configured to connect via a proxy
	* Fixed issues found by the SecDir review of the "keystore" draft.
	* Updated the "ietf-tcp-client" module to use the new "password-
	grouping" grouping from the "crypto-types" module.
	A.9. 08 to 09
	* Addressed comments raised by YANG Doctor in the ct/ts/ks drafts.
	A.10. 09 to 10
	* Updated Abstract and Intro to address comments by Tom Petch.
	* Removed the "tcp-connection-grouping" grouping (now models use the
	"tcp-common-grouping" directly).
	* Added XML-comment above examples explaining the reason for the
	unusual top-most element's presence.
	* Added Securty Considerations section for the "local-binding-
	supported" feature.
	* Replaced some hardcoded refs to <xref> elements.
	* Fixed nits found by YANG Doctor reviews.
	* Aligned modules with `pyang -f` formatting.
	* Added an "Acknowledgements" secetion.
	A.11. 10 to 11
	* Replaced "base64encodedvalue==" with "BASE64VALUE=" in examples.
	* Minor editorial nits
	A.12. 11 to 12
	* Fixed up the 'WG Web' and 'WG List' lines in YANG module(s)
	* Fixed up copyright (i.e., s/Simplified/Revised/) in YANG module(s)
	A.13. 12 to 13
	* NO UPDATE.
	A.14. 13 to 14
	* Updated per Shepherd reviews impacting the suite of drafts.
	A.15. 14 to 15
	* Updated per Shepherd reviews impacting the suite of drafts.
	A.16. 15 to 16
	* Updated per Tom Petch review.
	* Added refs to RFC9293 and SOCKS 4A.
	* Fixed examples to use IETF-sanctioned values for examples.
	A.17. 16 to 17
	* Addresses AD review comments.
	* Added note to Editor to fix line foldings.
	* Added Security Considerations text to also look a SC-section from
	imported modules.
	* Fixed bug: s/augment "keepalives"/refine "keepalives"/
	* Set defaults for idle-time, max-probes, and probe-interval
	(removed "mandatory true").
	* Updated examples to use IETF recommended values for examples.
	A.18. 18 to 19
	* Addresses AD review by Rob Wilton.
	A.19. 18 to 19
	* Replace RFC 1122 with RFC 9293.
	A.20. 19 to 20
	* Addresses 1st-round of IESG reviews.
	A.21. 20 to 22
	* Addresses issues found in OpsDir review of the ssh-client-server
	draft.
	* Updated to address Mallory Knodel's Gen-ART review.
	* Renamed Security Considerations section s/Template for/
	Considerations for/
	* s/defines/presents/ in a few places.
	* Add refs to where the 'operational' and 'system' datastores are
	defined.
	* Added more 'feature' statements and descriptions for them
	* Added Security Considaration for the "password" node
	A.22. 22 to 23
	* Address IESG review comments.		[RFC9641] Watsen, K., "A YANG Data Model for a Truststore",
			RFC 9641, DOI 10.17487/RFC9641, October 2024,
			<https://www.rfc-editor.org/info/rfc9641>.
	A.23. 23 to 24		[RFC9642] Watsen, K., "A YANG Data Model for a Keystore", RFC 9642,
			DOI 10.17487/RFC9642, October 2024,
			<https://www.rfc-editor.org/info/rfc9642>.
	* Nothing changed. Bumped only for automation.		[RFC9644] Watsen, K., "YANG Groupings for SSH Clients and SSH
			Servers", RFC 9644, DOI 10.17487/RFC9644, October 2024,
			<https://www.rfc-editor.org/info/rfc9644>.
	A.24. 24 to 25		[RFC9645] Watsen, K., "YANG Groupings for TLS Clients and TLS
			Servers", RFC 9645, DOI 10.17487/RFC9645, October 2024,
			<https://www.rfc-editor.org/info/rfc9645>.
	* Updated to support dual-stacks		[SOCKS] Koblas, D. and M. Koblas, "SOCKS", USENIX UNIX Security
			Symposium III, September 1992, <https://www.usenix.org/leg
			acy/publications/library/proceedings/sec92/full_papers/
			koblas.pdf>.
	A.25. 25 to 26		[SOCKS_4A] Lee, Y., "SOCKS 4A: A Simple Extension to SOCKS 4
			Protocol", <https://www.openssh.com/txt/socks4a.protocol>.
	* Updated to ensure at least one local-bind is specified.		[W3C.REC-xml-20081126]
			Bray, T., Paoli, J., Sperberg-McQueen, C.M., Maler, E.,
			and F. Yergeau, "Extensible Markup Language (XML) 1.0
			(Fifth Edition)", World Wide Web Consortium
			Recommendation REC-xml-20081126, November 2008,
			<https://www.w3.org/TR/2008/REC-xml-20081126/>.
	Acknowledgements		Acknowledgements
	The authors would like to thank the following for lively discussions		The authors would like to thank the following for lively discussions
	on list and in the halls (ordered by first name): Éric Vyncke, Joe		on list and in the halls (ordered by first name): Éric Vyncke, Joe
	Clarke, Jürgen Schönwälder, Ladislav Lhotka, Mallory Knodel, Martin		Clarke, Jürgen Schönwälder, Ladislav Lhotka, Mallory Knodel, Martin
	Duke, Michael Tüxen, Mohamed Boucadair, Nancy Cam-Winget, Nick		Duke, Michael Tüxen, Mohamed Boucadair, Nancy Cam-Winget, Nick
	Hancock, Per Andersson, Rob Wilton, Roman Danyliw, Tom Petch, Wim		Hancock, Per Andersson, Rob Wilton, Roman Danyliw, Tom Petch, and Wim
	Henderickx.		Henderickx.
	Authors' Addresses		Authors' Addresses
	Kent Watsen		Kent Watsen
	Watsen Networks		Watsen Networks
	Email: kent+ietf@watsen.net		Email: kent+ietf@watsen.net
	Michael Scharf		Michael Scharf
	Hochschule Esslingen - University of Applied Sciences		Hochschule Esslingen
			University of Applied Sciences
			Kanalstr. 33
			73728 Esslingen am Neckar
			Germany
	Email: michael.scharf@hs-esslingen.de		Email: michael.scharf@hs-esslingen.de
End of changes. 187 change blocks.
	652 lines changed or deleted		411 lines changed or added
This html diff was produced by rfcdiff 1.48.