Re: Documenting the "QUIC API"
Martin Thomson <mt@lowentropy.net> Thu, 27 March 2025 00:24 UTC
Return-Path: <mt@lowentropy.net>
X-Original-To: quic@mail2.ietf.org
Delivered-To: quic@mail2.ietf.org
Received: from localhost (localhost [127.0.0.1]) by mail2.ietf.org (Postfix) with ESMTP id A989012E8728 for <quic@mail2.ietf.org>; Wed, 26 Mar 2025 17:24:25 -0700 (PDT)
X-Virus-Scanned: amavisd-new at ietf.org
X-Spam-Flag: NO
X-Spam-Score: -2.797
X-Spam-Level:
X-Spam-Status: No, score=-2.797 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H5=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, RCVD_IN_VALIDITY_SAFE_BLOCKED=0.001, SPF_PASS=-0.001] autolearn=unavailable autolearn_force=no
Authentication-Results: mail2.ietf.org (amavisd-new); dkim=pass (2048-bit key) header.d=lowentropy.net header.b="UN+ocTXN"; dkim=pass (2048-bit key) header.d=messagingengine.com header.b="XXwr3hUe"
Received: from mail2.ietf.org ([166.84.6.31]) by localhost (mail2.ietf.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id NlSwhpIw7EpD for <quic@mail2.ietf.org>; Wed, 26 Mar 2025 17:24:25 -0700 (PDT)
Received: from fhigh-a1-smtp.messagingengine.com (fhigh-a1-smtp.messagingengine.com [103.168.172.152]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-256) server-digest SHA256) (No client certificate requested) by mail2.ietf.org (Postfix) with ESMTPS id CE97B12E7FFE for <quic@ietf.org>; Wed, 26 Mar 2025 17:18:04 -0700 (PDT)
Received: from phl-compute-07.internal (phl-compute-07.phl.internal [10.202.2.47]) by mailfhigh.phl.internal (Postfix) with ESMTP id B75A61140138; Wed, 26 Mar 2025 20:18:04 -0400 (EDT)
Received: from phl-imap-01 ([10.202.2.91]) by phl-compute-07.internal (MEProxy); Wed, 26 Mar 2025 20:18:04 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lowentropy.net; h=cc:cc:content-transfer-encoding:content-type:content-type :date:date:from:from:in-reply-to:in-reply-to:message-id :mime-version:references:reply-to:subject:subject:to:to; s=fm3; t=1743034684; x=1743121084; bh=fsIO9HQTOImQCcUltT3eXnMcCY1Fq9VJ CtkVWPp/JRE=; b=UN+ocTXNySE0IR1/2uOMi2EiblI0FDqkOWc2QgY9cBL0C5rf cGbMMwZ6K2Y6VTrNjItdJybq5Vkz9I82HQOkRuJCwPoaNW6DdYz+tIdaw0fs9U9v 6xYilUYywnlYB/PH1aSQqW0GUzxPMVCAtElWb48/7olwgzzbOdQQOXX83G1y6hXO tJlwPhAamMd/S/qimvxBT1aCTwAZ5L43pcX6lsgH2ZMESUN4pRqHtlh0NH3kcjCi FhhyI/xKEbgfhxcMeuEuZ48WYpoWheVN6N588YmMm3B4XqvcdfONJ/3LZeApOyOM ddFjNsnGr/jyeD0wMEPKBEmJlrXIbwboJ3tp/A==
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:content-type:date:date:feedback-id:feedback-id :from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm2; t=1743034684; x= 1743121084; bh=fsIO9HQTOImQCcUltT3eXnMcCY1Fq9VJCtkVWPp/JRE=; b=X Xwr3hUeeTIkxJ9OhuPtYIufzKMvwCStkKZI1xV/OtccU+E4vbdDPmegufuDGv+iv AVCuNtkjSP4rvXRcFE0YJK07h809U2SpPwTUhNphDUEWq25SX3bjRoBWicS4XbSQ n3MXx3Nar5f2SikKZOrth+v06jGYDMHmj682h5vlifwlBHUIshMmwzZqFCQXEVvc xxVwcASy+z1CT2Fse9h8MoYHdnwaMtcJzIPSdDoVOPFeon7W4ybLK5oBM6QCZaG0 AAfm3Q8vNQl9Y200Z8wLDhuztc6SgOdlfC6913MmWU51KxCPpJ9/hl0rq/qRlkKg qMuGxMljQPkwuT2xFRZCQ==
X-ME-Sender: <xms:PJnkZ2vSlA-RSDZE-9KR2RqTccqfRIngWeNfkFOw7_6jbwYqBK6ZkQ> <xme:PJnkZ7fVA2Sg9qiLlxe1vjExf-bbvtFmsb6adB7UEy_nJJRpIdxvmRfhkP8fDobxD 4QHTYCvO_rOg0mt1H0>
X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeefvddrtddtgdduieeileehucetufdoteggodetrf dotffvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdggtfgfnhhsuhgsshgtrhhisggv pdfurfetoffkrfgpnffqhgenuceurghilhhouhhtmecufedttdenucesvcftvggtihhpih gvnhhtshculddquddttddmnecujfgurhepofggfffhvfevkfgjfhfutgfgsehtjeertder tddtnecuhfhrohhmpedfofgrrhhtihhnucfvhhhomhhsohhnfdcuoehmtheslhhofigvnh htrhhophihrdhnvghtqeenucggtffrrghtthgvrhhnpeekieetffduvddvvdevteeghffh hefghfeitefhudeltddvveeivedvgfegueevkeenucffohhmrghinhepihgvthhfrdhorh hgnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehmrghilhhfrhhomhepmhht sehlohifvghnthhrohhphidrnhgvthdpnhgspghrtghpthhtohepfedpmhhouggvpehsmh htphhouhhtpdhrtghpthhtohepkhgriihuhhhoohhkuhesghhmrghilhdrtghomhdprhgt phhtthhopehquhhitgesihgvthhfrdhorhhgpdhrtghpthhtoheplhhutggrsheslhhutg grshhprghrughuvgdrtghomh
X-ME-Proxy: <xmx:PJnkZxzBuLWOZHmEMRCwHk8ZKBO6XQ0QA6aBqHXi8BKjxoY9b31LZA> <xmx:PJnkZxPN3O8LG0HBKUihCpG956dxqtrPNNnCSdnQ8F_rZeCrVfO4zQ> <xmx:PJnkZ28nCkUm4G_gUO2_qT5x06nQmBgFH3B0pNquucrxae2XBK4qfw> <xmx:PJnkZ5Ug-6GSMfWprHatPbIZaUOdmpCMIu0nW3-kt8EWnyl3vIJSXQ> <xmx:PJnkZ4ITo5UhXixgCnkxZBr2V8W0H-GuGmBokgcpVYNt28Pfkp5XaGNw>
Feedback-ID: ic129442d:Fastmail
Received: by mailuser.phl.internal (Postfix, from userid 501) id 4EC28336007E; Wed, 26 Mar 2025 20:18:04 -0400 (EDT)
X-Mailer: MessagingEngine.com Webmail Interface
MIME-Version: 1.0
X-ThreadId: Te39e55828c099b41
Date: Thu, 27 Mar 2025 11:17:43 +1100
From: Martin Thomson <mt@lowentropy.net>
To: Kazuho Oku <kazuhooku@gmail.com>, Lucas Pardue <lucas@lucaspardue.com>
Message-Id: <f659e75f-c1b6-41ae-9316-5a72a1d8ba91@betaapp.fastmail.com>
In-Reply-To: <CANatvzxWUwRi-bKFXrf-3NdGiG8M4CkJ-+Mm6KagMSeL72J-cg@mail.gmail.com>
References: <042C4DD9-441C-4292-BDDC-42A140E25701@fb.com> <F1B358B2-11BB-4137-B49A-BCE13CCBFA60@ifi.uio.no> <1caa1a28-1e88-4405-8896-4151d070db3d@app.fastmail.com> <CANatvzxWUwRi-bKFXrf-3NdGiG8M4CkJ-+Mm6KagMSeL72J-cg@mail.gmail.com>
Subject: Re: Documenting the "QUIC API"
Content-Type: text/plain
Content-Transfer-Encoding: 7bit
Message-ID-Hash: 6WQGMAMDZLCYTX2J67G7ZORPREVAJP6X
X-Message-ID-Hash: 6WQGMAMDZLCYTX2J67G7ZORPREVAJP6X
X-MailFrom: mt@lowentropy.net
X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-quic.ietf.org-0; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header
CC: "quic@ietf.org" <quic@ietf.org>
X-Mailman-Version: 3.3.9rc6
Precedence: list
List-Id: Main mailing list of the IETF QUIC working group <quic.ietf.org>
Archived-At: <https://mailarchive.ietf.org/arch/msg/quic/kDs6H8qEmJDO0ydDv3bdwgHhjtw>
List-Archive: <https://mailarchive.ietf.org/arch/browse/quic>
List-Help: <mailto:quic-request@ietf.org?subject=help>
List-Owner: <mailto:quic-owner@ietf.org>
List-Post: <mailto:quic@ietf.org>
List-Subscribe: <mailto:quic-join@ietf.org>
List-Unsubscribe: <mailto:quic-leave@ietf.org>
On Thu, Mar 27, 2025, at 09:44, Kazuho Oku wrote: > I do not think we can agree on a single API that defines how > applications and QUIC stacks should communicate, nor would it be a good > idea to do so. I completely agree. Though with things like DATAGRAM, RESET_STREAM_AT and some of the discussion about how webtransport might implement another layer of flow control, there are still some open questions about how the general shape of the interface might change over time. I don't know if that is what Alan was getting at, but it seems like there is at least some work to be done there, if only to evolve https://datatracker.ietf.org/doc/html/rfc9000#name-operations-on-streams
- Documenting the "QUIC API" Alan Frindell
- Re: Documenting the "QUIC API" Michael Welzl
- Re: Documenting the "QUIC API" Lucas Pardue
- Re: Documenting the "QUIC API" Kazuho Oku
- Re: Documenting the "QUIC API" Martin Thomson
- Re: Documenting the "QUIC API" Lucas Pardue
- Re: Documenting the "QUIC API" Lars Eggert
- Re: Documenting the "QUIC API" Ian Swett