< draft-dreibholz-tsvwg-sctpsocket-sqinfo-23.txt   draft-dreibholz-tsvwg-sctpsocket-sqinfo-24.txt >
Network Working Group T. Dreibholz Network Working Group T. Dreibholz
Internet-Draft SimulaMet Internet-Draft SimulaMet
Intended status: Experimental R. Seggelmann Intended status: Experimental R. Seggelmann
Expires: March 10, 2022 Muenster Univ. of App. Sciences Expires: 22 September 2022 Münster Univ. of App. Sciences
M. Becke M. Becke
HAW Hamburg HAW Hamburg
September 06, 2021 21 March 2022
Sender Queue Info Option for the SCTP Socket API Sender Queue Info Option for the SCTP Socket API
draft-dreibholz-tsvwg-sctpsocket-sqinfo-23 draft-dreibholz-tsvwg-sctpsocket-sqinfo-24
Abstract Abstract
This document describes an extension to the SCTP sockets API for This document describes an extension to the SCTP sockets API for
querying information about the sender queue. querying information about the sender queue.
Status of This Memo Status of This Memo
This Internet-Draft is submitted in full conformance with the This Internet-Draft is submitted in full conformance with the
provisions of BCP 78 and BCP 79. provisions of BCP 78 and BCP 79.
skipping to change at page 1, line 34 skipping to change at page 1, line 34
Internet-Drafts are working documents of the Internet Engineering Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet- working documents as Internet-Drafts. The list of current Internet-
Drafts is at https://datatracker.ietf.org/drafts/current/. Drafts is at https://datatracker.ietf.org/drafts/current/.
Internet-Drafts are draft documents valid for a maximum of six months Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress." material or to cite them other than as "work in progress."
This Internet-Draft will expire on March 10, 2022. This Internet-Draft will expire on 22 September 2022.
Copyright Notice Copyright Notice
Copyright (c) 2021 IETF Trust and the persons identified as the Copyright (c) 2022 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 Provisions Relating to IETF Documents (https://trustee.ietf.org/
(https://trustee.ietf.org/license-info) in effect on the date of license-info) in effect on the date of publication of this document.
publication of this document. Please review these documents Please review these documents carefully, as they describe your rights
carefully, as they describe your rights and restrictions with respect and restrictions with respect to this document. Code Components
to this document. Code Components extracted from this document must extracted from this document must include Revised BSD License text as
include Simplified BSD License text as described in Section 4.e of described in Section 4.e of the Trust Legal Provisions and are
the Trust Legal Provisions and are provided without warranty as provided without warranty as described in the Revised BSD License.
described in the Simplified BSD License.
Table of Contents Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2
2. Conventions . . . . . . . . . . . . . . . . . . . . . . . . . 2 2. Conventions . . . . . . . . . . . . . . . . . . . . . . . . . 2
3. Sender Queue Info (SCTP_SQINFO) . . . . . . . . . . . . . . . 2 3. Sender Queue Info (SCTP_SQINFO) . . . . . . . . . . . . . . . 2
4. Testbed Platform . . . . . . . . . . . . . . . . . . . . . . 3 4. Testbed Platform . . . . . . . . . . . . . . . . . . . . . . 3
5. Security Considerations . . . . . . . . . . . . . . . . . . . 3 5. Security Considerations . . . . . . . . . . . . . . . . . . . 3
6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 4 6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 3
7. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 4 7. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 4
8. References . . . . . . . . . . . . . . . . . . . . . . . . . 4 8. References . . . . . . . . . . . . . . . . . . . . . . . . . 4
8.1. Normative References . . . . . . . . . . . . . . . . . . 4 8.1. Normative References . . . . . . . . . . . . . . . . . . 4
8.2. Informative References . . . . . . . . . . . . . . . . . 5 8.2. Informative References . . . . . . . . . . . . . . . . . 4
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 7 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 6
1. Introduction 1. Introduction
This draft describes an extension to the SCTP sockets API (see This draft describes an extension to the SCTP sockets API (see [4],
[RFC6458], [I-D.dreibholz-tsvwg-sctpsocket-multipath] [RFC4960]) [6] [3]) which allows an application to query the sender queue
which allows an application to query the sender queue utilization per utilization per stream. This information is necessary for
stream. This information is necessary for applications to make applications to make efficient use of a mapping of streams to
efficient use of a mapping of streams to dissimilar paths. A dissimilar paths. A detailed description including simulation
detailed description including simulation results can be found in results can be found in [7].
[PFLDNeT2010].
In particular, this API extension is useful when using the CMT-SCTP, In particular, this API extension is useful when using the CMT-SCTP,
CMT/RPv1-SCTP, CMT/RPv2-SCTP and MPTCP-like extensions (see CMT/RPv1-SCTP, CMT/RPv2-SCTP and MPTCP-like extensions (see [5],
[I-D.tuexen-tsvwg-sctp-multipath], [Dre2012], [PAMS2012], [PAMS2011], [13], [12], [9], [10], [11], [8]) for Concurrent Multipath Transfer
[ConTEL2011], [SoftCOM2011], [Globecom2010]) for Concurrent Multipath (CMT) with SCTP.
Transfer (CMT) with SCTP.
2. Conventions 2. Conventions
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 BCP
14 [RFC2119] [RFC8174] when, and only when, they appear in all 14 [1] [2] when, and only when, they appear in all capitals, as shown
capitals, as shown here. here.
3. Sender Queue Info (SCTP_SQINFO) 3. Sender Queue Info (SCTP_SQINFO)
This socket option obtains the maximum sender queue size (in bytes), This socket option obtains the maximum sender queue size (in bytes),
the current total sender queue utilization (in bytes) as well as the the current total sender queue utilization (in bytes) as well as the
current utilization per stream (in bytes). current utilization per stream (in bytes).
The following structure is used to obtain the sender queue The following structure is used to obtain the sender queue
information: information:
skipping to change at page 3, line 41 skipping to change at page 3, line 41
Note, that the caller of getsockopt() MUST provide a Note, that the caller of getsockopt() MUST provide a
sctp_sndqueueinfo structure which can hold at least as many sctp_sndqueueinfo structure which can hold at least as many
sq_queued_on_stream entries as the association's number of outgoing sq_queued_on_stream entries as the association's number of outgoing
streams. Otherwise, the getsockopt() call will fail and return an streams. Otherwise, the getsockopt() call will fail and return an
error. error.
4. Testbed Platform 4. Testbed Platform
A large-scale and realistic Internet testbed platform with support A large-scale and realistic Internet testbed platform with support
for the multi-homing feature of the underlying SCTP protocol is for the multi-homing feature of the underlying SCTP protocol is
NorNet. A description of NorNet is provided in [PAMS2013-NorNet], NorNet. A description of NorNet is provided in [14], [15], some
[ComNets2013-Core], some further information can be found on the further information can be found on the project website [16].
project website [NorNet-Website].
5. Security Considerations 5. Security Considerations
Security considerations for the SCTP sockets API are described by Security considerations for the SCTP sockets API are described by
[RFC6458]. [4].
6. IANA Considerations 6. IANA Considerations
This document does not require IANA actions. This document does not require IANA actions.
7. Acknowledgments 7. Acknowledgments
The authors would like to thank Michael Tuexen and Irene Ruengeler The authors would like to thank Michael Tuexen and Irene Ruengeler
for their support. for their support.
8. References 8. References
8.1. Normative References 8.1. Normative References
[I-D.dreibholz-tsvwg-sctpsocket-multipath] [1] Bradner, S., "Key words for use in RFCs to Indicate
Dreibholz, T., Becke, M., and H. Adhari, "SCTP Socket API
Extensions for Concurrent Multipath Transfer", draft-
dreibholz-tsvwg-sctpsocket-multipath-22 (work in
progress), March 2021.
[I-D.tuexen-tsvwg-sctp-multipath]
Amer, P. D., Becke, M., Dreibholz, T., Ekiz, N., Iyengar,
J., Natarajan, P., Stewart, R. R., and M. Tuexen, "Load
Sharing for the Stream Control Transmission Protocol
(SCTP)", draft-tuexen-tsvwg-sctp-multipath-22 (work in
progress), August 2021.
[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>.
[RFC4960] Stewart, R., Ed., "Stream Control Transmission Protocol", [2] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC
2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174,
May 2017, <https://www.rfc-editor.org/info/rfc8174>.
[3] Stewart, R., Ed., "Stream Control Transmission Protocol",
RFC 4960, DOI 10.17487/RFC4960, September 2007, RFC 4960, DOI 10.17487/RFC4960, September 2007,
<https://www.rfc-editor.org/info/rfc4960>. <https://www.rfc-editor.org/info/rfc4960>.
[RFC6458] Stewart, R., Tuexen, M., Poon, K., Lei, P., and V. [4] Stewart, R., Tuexen, M., Poon, K., Lei, P., and V.
Yasevich, "Sockets API Extensions for the Stream Control Yasevich, "Sockets API Extensions for the Stream Control
Transmission Protocol (SCTP)", RFC 6458, Transmission Protocol (SCTP)", RFC 6458,
DOI 10.17487/RFC6458, December 2011, DOI 10.17487/RFC6458, December 2011,
<https://www.rfc-editor.org/info/rfc6458>. <https://www.rfc-editor.org/info/rfc6458>.
[RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC [5] Amer, P. D., Becke, M., Dreibholz, T., Ekiz, N., Iyengar,
2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174, J., Natarajan, P., Stewart, R. R., and M. Tuexen, "Load
May 2017, <https://www.rfc-editor.org/info/rfc8174>. Sharing for the Stream Control Transmission Protocol
(SCTP)", Work in Progress, Internet-Draft, draft-tuexen-
tsvwg-sctp-multipath-23, 9 February 2022,
<https://www.ietf.org/archive/id/draft-tuexen-tsvwg-sctp-
multipath-23.txt>.
8.2. Informative References [6] Dreibholz, T., Becke, M., and H. Adhari, "SCTP Socket API
Extensions for Concurrent Multipath Transfer", Work in
Progress, Internet-Draft, draft-dreibholz-tsvwg-
sctpsocket-multipath-23, 6 September 2021,
<https://www.ietf.org/archive/id/draft-dreibholz-tsvwg-
sctpsocket-multipath-23.txt>.
[ComNets2013-Core] 8.2. Informative References
Gran, E., Dreibholz, T., and A. Kvalbein, "NorNet Core - A
Multi-Homed Research Testbed", Computer Networks, Special
Issue on Future Internet Testbeds Volume 61, Pages 75-87,
ISSN 1389-1286, DOI 10.1016/j.bjp.2013.12.035, March 2014,
<https://www.simula.no/file/simulasimula2236pdf/download>.
[ConTEL2011] [7] Dreibholz, T., Seggelmann, R., Tüxen, M., and E. P.
Dreibholz, T., Becke, M., Adhari, H., and E. Rathgeb, "On Rathgeb, "Transmission Scheduling Optimizations for
the Impact of Congestion Control for Concurrent Multipath Concurrent Multipath Transfer", Proceedings of the 8th
Transfer on the Transport Layer", Proceedings of the 11th International Workshop on Protocols for Future, Large-
IEEE International Conference on Scale and Diverse Network Transports (PFLDNeT) Volume 8,
Telecommunications (ConTEL) Pages 397-404, ISSN 2074-5168, 29 November 2010, <https://www.wiwi.uni-
ISBN 978-953-184-152-8, June 2011, <https://www.wiwi.uni-
due.de/fileadmin/fileupload/I-TDR/SCTP/Paper/ due.de/fileadmin/fileupload/I-TDR/SCTP/Paper/
ConTEL2011.pdf>. PFLDNeT2010.pdf>.
[Dre2012] Dreibholz, T., "Evaluation and Optimisation of Multi-Path
Transport using the Stream Control Transmission
Protocol", Habilitation Treatise, March 2012,
<https://duepublico.uni-duisburg-
essen.de/servlets/DerivateServlet/Derivate-29737/
Dre2012_final.pdf>.
[Globecom2010] [8] Dreibholz, T., Becke, M., Rathgeb, E. P., and M. Tüxen,
Dreibholz, T., Becke, M., Rathgeb, E., and M. Tuexen, "On "On the Use of Concurrent Multipath Transfer over
the Use of Concurrent Multipath Transfer over Asymmetric Asymmetric Paths", Proceedings of the IEEE Global
Paths", Proceedings of the IEEE Global Communications Communications
Conference (GLOBECOM) ISBN 978-1-4244-5637-6, Conference (GLOBECOM) ISBN 978-1-4244-5637-6,
DOI 10.1109/GLOCOM.2010.5683579, December 2010, DOI 10.1109/GLOCOM.2010.5683579, 7 December 2010,
<https://www.wiwi.uni-due.de/fileadmin/fileupload/I- <https://www.wiwi.uni-due.de/fileadmin/fileupload/I-
TDR/SCTP/Paper/Globecom2010.pdf>. TDR/SCTP/Paper/Globecom2010.pdf>.
[NorNet-Website] [9] Adhari, H., Dreibholz, T., Becke, M., Rathgeb, E. P., and
Dreibholz, T., "NorNet - A Real-World, Large-Scale Multi- M. Tüxen, "Evaluation of Concurrent Multipath Transfer
Homing Testbed", Online: https://www.nntb.no/, 2019, over Dissimilar Paths", Proceedings of the 1st
<https://www.nntb.no/>. International Workshop on Protocols and Applications with
Multi-Homing Support (PAMS) Pages 708-714,
ISBN 978-0-7695-4338-3, DOI 10.1109/WAINA.2011.92, 22
March 2011, <https://www.wiwi.uni-
due.de/fileadmin/fileupload/I-TDR/SCTP/Paper/
PAMS2011.pdf>.
[PAMS2011] [10] Dreibholz, T., Becke, M., Adhari, H., and E. P. Rathgeb,
Adhari, H., Dreibholz, T., Becke, M., Rathgeb, E., and M. "On the Impact of Congestion Control for Concurrent
Tuexen, "Evaluation of Concurrent Multipath Transfer over Multipath Transfer on the Transport Layer", Proceedings of
Dissimilar Paths", Proceedings of the 1st International the 11th IEEE International Conference on
Workshop on Protocols and Applications with Multi-Homing Telecommunications (ConTEL) Pages 397-404,
Support (PAMS) Pages 708-714, ISBN 978-0-7695-4338-3, ISBN 978-953-184-152-8, 16 June 2011,
DOI 10.1109/WAINA.2011.92, March 2011,
<https://www.wiwi.uni-due.de/fileadmin/fileupload/I- <https://www.wiwi.uni-due.de/fileadmin/fileupload/I-
TDR/SCTP/Paper/PAMS2011.pdf>. TDR/SCTP/Paper/ConTEL2011.pdf>.
[PAMS2012] [11] Dreibholz, T., Becke, M., Adhari, H., and E. P. Rathgeb,
Dreibholz, T., Adhari, H., Becke, M., and E. Rathgeb, "Evaluation of A New Multipath Congestion Control Scheme
using the NetPerfMeter Tool-Chain", Proceedings of the
19th IEEE International Conference on Software,
Telecommunications and Computer Networks (SoftCOM) Pages
1-6, ISBN 978-953-290-027-9, 16 September 2011,
<https://www.wiwi.uni-due.de/fileadmin/fileupload/I-
TDR/SCTP/Paper/SoftCOM2011.pdf>.
[12] Dreibholz, T., Adhari, H., Becke, M., and E. P. Rathgeb,
"Simulation and Experimental Evaluation of Multipath "Simulation and Experimental Evaluation of Multipath
Congestion Control Strategies", Proceedings of the 2nd Congestion Control Strategies", Proceedings of the 2nd
International Workshop on Protocols and Applications with International Workshop on Protocols and Applications with
Multi-Homing Support (PAMS) ISBN 978-0-7695-4652-0, Multi-Homing Support (PAMS) ISBN 978-0-7695-4652-0,
DOI 10.1109/WAINA.2012.186, March 2012, DOI 10.1109/WAINA.2012.186, 29 March 2012,
<https://www.wiwi.uni-due.de/fileadmin/fileupload/I- <https://www.wiwi.uni-due.de/fileadmin/fileupload/I-
TDR/SCTP/Paper/PAMS2012.pdf>. TDR/SCTP/Paper/PAMS2012.pdf>.
[PAMS2013-NorNet] [13] Dreibholz, T., "Evaluation and Optimisation of Multi-Path
Dreibholz, T. and E. Gran, "Design and Implementation of Transport using the Stream Control Transmission
the NorNet Core Research Testbed for Multi-Homed Systems", Protocol", Habilitation Treatise, 13 March 2012,
Proceedings of the 3nd International Workshop on Protocols <https://duepublico.uni-duisburg-
and Applications with Multi-Homing Support (PAMS) Pages essen.de/servlets/DerivateServlet/Derivate-29737/
1094-1100, ISBN 978-0-7695-4952-1, Dre2012_final.pdf>.
DOI 10.1109/WAINA.2013.71, March 2013,
[14] Dreibholz, T. and E. G. Gran, "Design and Implementation
of the NorNet Core Research Testbed for Multi-Homed
Systems", Proceedings of the 3nd International Workshop on
Protocols and Applications with Multi-Homing
Support (PAMS) Pages 1094-1100, ISBN 978-0-7695-4952-1,
DOI 10.1109/WAINA.2013.71, 27 March 2013,
<https://www.simula.no/file/ <https://www.simula.no/file/
threfereedinproceedingsreference2012-12-207643198512pdf/ threfereedinproceedingsreference2012-12-207643198512pdf/
download>. download>.
[PFLDNeT2010] [15] Gran, E. G., Dreibholz, T., and A. Kvalbein, "NorNet Core
Dreibholz, T., Seggelmann, R., Tuexen, M., and E. Rathgeb, – A Multi-Homed Research Testbed", Computer Networks,
"Transmission Scheduling Optimizations for Concurrent Special Issue on Future Internet Testbeds Volume 61, Pages
Multipath Transfer", Proceedings of the 8th International 75-87, ISSN 1389-1286, DOI 10.1016/j.bjp.2013.12.035, 14
Workshop on Protocols for Future, Large-Scale and Diverse March 2014,
Network Transports (PFLDNeT) Volume 8, ISSN 2074-5168, <https://www.simula.no/file/simulasimula2236pdf/download>.
November 2010, <https://www.wiwi.uni-
due.de/fileadmin/fileupload/I-TDR/SCTP/Paper/
PFLDNeT2010.pdf>.
[SoftCOM2011] [16] Dreibholz, T., "NorNet – A Real-World, Large-Scale Multi-
Dreibholz, T., Becke, M., Adhari, H., and E. Rathgeb, Homing Testbed", 2022, <https://www.nntb.no/>.
"Evaluation of A New Multipath Congestion Control Scheme
using the NetPerfMeter Tool-Chain", Proceedings of the
19th IEEE International Conference on Software,
Telecommunications and Computer Networks (SoftCOM) Pages
1-6, ISBN 978-953-290-027-9, September 2011,
<https://www.wiwi.uni-due.de/fileadmin/fileupload/I-
TDR/SCTP/Paper/SoftCOM2011.pdf>.
Authors' Addresses Authors' Addresses
Thomas Dreibholz Thomas Dreibholz
Simula Metropolitan Centre for Digital Engineering Simula Metropolitan Centre for Digital Engineering
Pilestredet 52 Pilestredet 52
0167 Oslo, Oslo 0167 Oslo
Norway Norway
Phone: +47-6782-8200
Fax: +47-6782-8201
Email: dreibh@simula.no Email: dreibh@simula.no
URI: https://www.simula.no/people/dreibh URI: https://www.simula.no/people/dreibh
Robin Seggelmann Robin Seggelmann
Muenster University of Applied Sciences Münster University of Applied Sciences
Stegerwaldstrasse 39 Stegerwaldstraße 39
48565 Steinfurt, Nordrhein-Westfalen 48565 Steinfurt
Germany Germany
Email: seggelmann@fh-muenster.de Email: seggelmann@fh-muenster.de
Martin Becke Martin Becke
HAW Hamburg, Informatics Department HAW Hamburg, Informatics Department
Berliner Tor 7 Berliner Tor 7
20099 Hamburg, Hamburg 20099 Hamburg
Germany Germany
Phone: +49-40-42875-8104 Phone: +49-40-42875-8104
Fax: +49-40-42875-8309
Email: martin.becke@haw-hamburg.de Email: martin.becke@haw-hamburg.de
URI: http://www.scimbe.de/about.html URI: http://www.scimbe.de/about.html
 End of changes. 39 change blocks. 
131 lines changed or deleted 115 lines changed or added

This html diff was produced by rfcdiff 1.48. The latest version is available from http://tools.ietf.org/tools/rfcdiff/