From nobody Mon Jun 29 15:52:16 2026 X-Original-To: dev-commits-src-main@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4gprPr6s7hz6jNd2 for ; Mon, 29 Jun 2026 15:52:16 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "YR1" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4gprPr51pkz3LG2 for ; Mon, 29 Jun 2026 15:52:16 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1782748336; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=X1pmQWU1I3HEZ+9SH8SLcpY62NNlWGKUE+LnlHcywzs=; b=F9K8IMawlN3TdfUQITBOw42gFixZJA8cCI4NRhS4aWJ4E3BxxEct7mMM5pdbetTc2CvA1J kA9Rsku3bbP40EHmdAerGmMpffhxB0cQLxfdMOelbxbDGOlzKpLKolZPgBISbDABfn9cxa mEjCDM6XNerXVT0X8GD7038REqvskgk6Y1uziYAaLbAtHCHA5RmmS8iC8tifiik8rwZf1z qcnmcB63yl4HXi6vI5B2Q5gw5la5vmsMfosrAN084DxFYhPtV+NgRcUm6dE3QhWWtA/tRQ glUbTqs7A/CJk08QTudCV6GvEq1I2uz9iByx+w/MYXMq7YqbB7oBj0XnVcfRqw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1782748336; a=rsa-sha256; cv=none; b=d1z5OlzU62bGQ6WL4AXz/jenhQUxLpJ0/PdEnJv6GXyCDiTisQvc8VFDyvTW4d+xMfA1OA mMgqwQ04qgiy9Bq9qd8+Dq8yZozf1+Wn2+htFf/n05JXqzY9fcz9S56F8NTf3tXikYVK/R iGeD0hWwuLT8utywyKvZGPXGz+dL2h3+xMPmkNfaB5mburtNo3btL+70vS6e3Kbjf2fmmc odkoIH3lM9cIcizdG3iBW8DVWFTvW/t6W4TaI7k/4YI+s9AxA6Mhnil1+rEI6Nq9YvFUWF ReMZ0AMqpwloerbRBaqTvF47YWZtoa/AFR53I5T0dJGhJ9OwKed5pXENTFL38Q== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1782748336; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=X1pmQWU1I3HEZ+9SH8SLcpY62NNlWGKUE+LnlHcywzs=; b=OVUU55jmzYdaMkd6ulAdGxxrodaQXnHqY7CsKOvUS4OB0YYhxjOv0z+MAT//qEzX52ybSe sc2tTt9qfSOVlur3EHCGcuFws0e5XqcVrZYZeVfXCwlk7WFRVbOPoy/6LRnec0gczN688P 3tvQTj12/VzTrgUlkzI62ZTdiIogn4KhFOLnGvo1URlfpH3AX107nT8DAENCiSeag/KOy1 NDUG2eS29kKZQLDaa6fvc0RMnMRdJVOH5ZwN10C380miQ81iV+oSTyJqd6k8J1NRPAmv3K wsXKyCqTc9SyFRufmhtIrJlwAytNAe1DVaG7f+Gd27yfxM6Q9p6ylJTGZC9NXg== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4gprPr4458z13dN for ; Mon, 29 Jun 2026 15:52:16 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 39867 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Mon, 29 Jun 2026 15:52:16 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Dag-Erling=?utf-8?Q? Sm=C3=B8rg?=rav Subject: git: c83e9ee0ef3e - main - libfetch: Document fetchTimeout List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: des X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: c83e9ee0ef3e6af982e6fd35afe420d460fa84b3 Auto-Submitted: auto-generated Date: Mon, 29 Jun 2026 15:52:16 +0000 Message-Id: <6a4294b0.39867.6a6baafc@gitrepo.freebsd.org> The branch main has been updated by des: URL: https://cgit.FreeBSD.org/src/commit/?id=c83e9ee0ef3e6af982e6fd35afe420d460fa84b3 commit c83e9ee0ef3e6af982e6fd35afe420d460fa84b3 Author: Dag-Erling Smørgrav AuthorDate: 2026-06-27 15:37:23 +0000 Commit: Dag-Erling Smørgrav CommitDate: 2026-06-29 13:49:19 +0000 libfetch: Document fetchTimeout Document the global fetchTimeout variable, now that it works reliably. MFC after: 1 week --- lib/libfetch/fetch.3 | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/lib/libfetch/fetch.3 b/lib/libfetch/fetch.3 index 20a22a263b5b..f76df3b027bd 100644 --- a/lib/libfetch/fetch.3 +++ b/lib/libfetch/fetch.3 @@ -24,7 +24,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd January 22, 2026 +.Dd June 27, 2026 .Dt FETCH 3 .Os .Sh NAME @@ -56,7 +56,8 @@ .Nm fetchGetFTP , .Nm fetchPutFTP , .Nm fetchStatFTP , -.Nm fetchListFTP +.Nm fetchListFTP , +.Nm fetchTimeout .Nd file transfer functions .Sh LIBRARY .Lb libfetch @@ -64,6 +65,7 @@ .In sys/param.h .In stdio.h .In fetch.h +.Vt extern int fetchTimeout; .Ft struct url * .Fn fetchMakeURL "const char *scheme" "const char *host" "int port" "const char *doc" "const char *user" "const char *pwd" .Ft struct url * @@ -289,6 +291,18 @@ or functions is read-only, and that a stream returned by one of the .Fn fetchPutXXX functions is write-only. +.Pp +The +.Va fetchTimeout +global variable can be set to the amount of time in seconds to wait +for each network operation, including each connection attempt (keeping +in mind that one name may resolve to multiple addresses which will +each be tried sequentially), each read, and each write. +Thus, +.Va fetchTimeout +can safely be set to a relatively low value without fear of +prematurely terminating a long transfer; it will only kick in if the +transfer is stalled. .Sh FILE SCHEME .Fn fetchXGetFile , .Fn fetchGetFile