| rfc9643v5.txt | rfc9643.txt | |||
|---|---|---|---|---|
| skipping to change at line 17 ¶ | skipping to change at line 17 ¶ | |||
| YANG Groupings for TCP Clients and TCP Servers | YANG Groupings for TCP Clients and TCP Servers | |||
| 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 data models defined by these modules may be used | proxies. The data models defined by these modules may be used | |||
| directly (e.g., to define a specific TCP-client or TCP-server) or in | directly (e.g., to define a specific TCP client or TCP server) or in | |||
| conjunction with the configuration defined for higher level protocols | conjunction with the configuration defined for higher level protocols | |||
| that depend on TCP (e.g., SSH, TLS, etc.). Examples of higher level | that depend on TCP (e.g., SSH, TLS, etc.). Examples of higher level | |||
| protocol configuration designed to be used in conjunction with this | protocol configuration designed to be used in conjunction with this | |||
| configuration are in RFCs 9644 and 9645. | configuration are in RFCs 9644 and 9645. | |||
| Status of This Memo | Status of This Memo | |||
| This is an Internet Standards Track document. | This is an Internet Standards Track document. | |||
| This document is a product of the Internet Engineering Task Force | This document is a product of the Internet Engineering Task Force | |||
| skipping to change at line 89 ¶ | skipping to change at line 89 ¶ | |||
| 7.1. Normative References | 7.1. Normative References | |||
| 7.2. Informative References | 7.2. Informative References | |||
| Acknowledgements | Acknowledgements | |||
| Authors' Addresses | Authors' Addresses | |||
| 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]). The data models defined by these modules may be used | [RFC9293]). The data models defined by these modules may be used | |||
| directly (e.g., to define a specific TCP-client or TCP-server) or in | directly (e.g., to define a specific TCP client or TCP server) or in | |||
| conjunction with the configuration defined for higher level protocols | conjunction with the configuration defined for higher level protocols | |||
| that depend on TCP (e.g., SSH, TLS, etc.). Examples of higher level | that depend on TCP (e.g., SSH, TLS, etc.). Examples of higher level | |||
| protocol configuration designed to be used in conjunction with this | protocol configuration designed to be used in conjunction with this | |||
| configuration are in [RFC9644] and [RFC9645]. | 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 TCP | enables modification of application-specific parameters for TCP | |||
| skipping to change at line 1200 ¶ | skipping to change at line 1200 ¶ | |||
| "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; | |||
| description | description | |||
| "The local port number to listen on for incoming TCP | "The local port number to listen on for incoming TCP | |||
| client connections.”; | client connections."; | |||
| } | } | |||
| } | } | |||
| 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."; | |||
| } | } | |||
| } | } | |||
| skipping to change at line 1437 ¶ | skipping to change at line 1437 ¶ | |||
| [RFC9000] Iyengar, J., Ed. and M. Thomson, Ed., "QUIC: A UDP-Based | [RFC9000] Iyengar, J., Ed. and M. Thomson, Ed., "QUIC: A UDP-Based | |||
| Multiplexed and Secure Transport", RFC 9000, | Multiplexed and Secure Transport", RFC 9000, | |||
| DOI 10.17487/RFC9000, May 2021, | DOI 10.17487/RFC9000, May 2021, | |||
| <https://www.rfc-editor.org/info/rfc9000>. | <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 | [RFC9640] Watsen, K., "YANG Data Types and Groupings for | |||
| Cryptography", RFC 9640, DOI 10.17487/RFC9640, September | Cryptography", RFC 9640, DOI 10.17487/RFC9640, October | |||
| 2024, <https://www.rfc-editor.org/info/rfc9640>. | 2024, <https://www.rfc-editor.org/info/rfc9640>. | |||
| 7.2. Informative References | 7.2. Informative References | |||
| [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-23, 15 August 2024, | netconf-http-client-server-23, 15 August 2024, | |||
| <https://datatracker.ietf.org/doc/html/draft-ietf-netconf- | <https://datatracker.ietf.org/doc/html/draft-ietf-netconf- | |||
| http-client-server-23>. | http-client-server-23>. | |||
| skipping to change at line 1519 ¶ | skipping to change at line 1519 ¶ | |||
| [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>. | |||
| [RFC8446] Rescorla, E., "The Transport Layer Security (TLS) Protocol | [RFC8446] Rescorla, E., "The Transport Layer Security (TLS) Protocol | |||
| Version 1.3", RFC 8446, DOI 10.17487/RFC8446, August 2018, | Version 1.3", RFC 8446, DOI 10.17487/RFC8446, August 2018, | |||
| <https://www.rfc-editor.org/info/rfc8446>. | <https://www.rfc-editor.org/info/rfc8446>. | |||
| [RFC9641] Watsen, K., "A YANG Data Model for a Truststore", | [RFC9641] Watsen, K., "A YANG Data Model for a Truststore", | |||
| RFC 9641, DOI 10.17487/RFC9641, September 2024, | RFC 9641, DOI 10.17487/RFC9641, October 2024, | |||
| <https://www.rfc-editor.org/info/rfc9641>. | <https://www.rfc-editor.org/info/rfc9641>. | |||
| [RFC9642] Watsen, K., "A YANG Data Model for a Keystore", RFC 9642, | [RFC9642] Watsen, K., "A YANG Data Model for a Keystore", RFC 9642, | |||
| DOI 10.17487/RFC9642, September 2024, | DOI 10.17487/RFC9642, October 2024, | |||
| <https://www.rfc-editor.org/info/rfc9642>. | <https://www.rfc-editor.org/info/rfc9642>. | |||
| [RFC9644] Watsen, K., "YANG Groupings for SSH Clients and SSH | [RFC9644] Watsen, K., "YANG Groupings for SSH Clients and SSH | |||
| Servers", RFC 9644, DOI 10.17487/RFC9644, September 2024, | Servers", RFC 9644, DOI 10.17487/RFC9644, October 2024, | |||
| <https://www.rfc-editor.org/info/rfc9644>. | <https://www.rfc-editor.org/info/rfc9644>. | |||
| [RFC9645] Watsen, K., "YANG Groupings for TLS Clients and TLS | [RFC9645] Watsen, K., "YANG Groupings for TLS Clients and TLS | |||
| Servers", RFC 9645, DOI 10.17487/RFC9645, September 2024, | Servers", RFC 9645, DOI 10.17487/RFC9645, October 2024, | |||
| <https://www.rfc-editor.org/info/rfc9645>. | <https://www.rfc-editor.org/info/rfc9645>. | |||
| [SOCKS] Koblas, D. and M. Koblas, "SOCKS", USENIX UNIX Security | [SOCKS] Koblas, D. and M. Koblas, "SOCKS", USENIX UNIX Security | |||
| Symposium III, September 1992, <https://www.usenix.org/leg | Symposium III, September 1992, <https://www.usenix.org/leg | |||
| acy/publications/library/proceedings/sec92/full_papers/ | acy/publications/library/proceedings/sec92/full_papers/ | |||
| koblas.pdf>. | koblas.pdf>. | |||
| [SOCKS_4A] Lee, Y., "SOCKS 4A: A Simple Extension to SOCKS 4 | [SOCKS_4A] Lee, Y., "SOCKS 4A: A Simple Extension to SOCKS 4 | |||
| Protocol", <https://www.openssh.com/txt/socks4a.protocol>. | Protocol", <https://www.openssh.com/txt/socks4a.protocol>. | |||
| End of changes. 8 change blocks. | ||||
| 8 lines changed or deleted | 8 lines changed or added | |||
This html diff was produced by rfcdiff 1.48. | ||||