From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-wm1-f47.google.com (mail-wm1-f47.google.com [209.85.128.47]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 230161E4AE for ; Wed, 25 Jun 2025 12:51:18 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.47 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1750855881; cv=none; b=innC2bz15oV5ZJGnTywlMhC1IDWJdBdh2kAL2UYlhHzwpEMMFAjYyYZM+xO647aNdfs3MP2Ac2aEtsBqVxoOtGHNa0bvP/55zeStZ48EvLGi0vMXajtPl1iTFOFuNqmGxO2r2A9JBmPwBwrsYzEc1qhohCKKt5RaD/tfuXHwS7Y= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1750855881; c=relaxed/simple; bh=wjNnOuSnYCgs3xYm8oKxcV7VQJI9B3dLWWlFaJdKozg=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=F9vEZyIcgSMm1aSn/FgbhNf4dDwOz0gyaxI+RRoXZeK3xf0Op7qLprIWQGTpDdEQNBZ8CChbddMhgfgv2zl20ABWZjp8+HQCbOMZpZWu78tzPKw1eIKS0fxraUW7P4bMq/VEo2Dkzn2on9dai/7q4JBCu2u46zYbNcODE91PJNI= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=YUvigVx6; arc=none smtp.client-ip=209.85.128.47 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="YUvigVx6" Received: by mail-wm1-f47.google.com with SMTP id 5b1f17b1804b1-453647147c6so16556735e9.2 for ; Wed, 25 Jun 2025 05:51:18 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1750855876; x=1751460676; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=NmdoYQyqRjSAdtaUm5pXv3i0/QWas9RqZ0kanE9Vu98=; b=YUvigVx6NQ47+KmfN7ard9z0WAM30TTkE71rS7Cm62gQWudTRe/cYmGr2K+4eLzT0W v8m5zjMgDwqCAtnF58htNSurjrP6Mk0rixusWnD8qqiMTJmjvRqV6eT9lAQFZlK6pJww Qsj8+fSXmQ3BCg0JK0IcrkG2OGN4iKMtD3b+VVzfK1mIHvKCItgh/ibAbfIaZLdkXske 72Mv/JALVbTrvEl1NoLGChweyUdnHVDvUYLVbYT282Wbpx8SiOm8679DvcyaxsqUdg0R p6Bvpucsf0PGmWGtJBeJ0QhotWl8T0CCHcei4f7YXvCj/5kdOk6+qlQm/CeBhLWZgu7w lWsQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1750855876; x=1751460676; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=NmdoYQyqRjSAdtaUm5pXv3i0/QWas9RqZ0kanE9Vu98=; b=XHKXe8tIob1ZOcbhBHtPADIAMHRvcAd1ldrA1DBfK+qR2u/+khzFltVKUEN6u64FsW hn+dmM90/pC84dounw+6I+Wdg4ZBNQ+Kg/0DrOsmub5s7UV+iyR1NYnWJfPDhLl1CaVj sxpVfpBvMEsR8G68TvEOU2onqDkX+ItY/5NgWQHVY1rGaqftRee+wj3y4DM76Izj0LlQ ktRF/HobkRSddQQaQ9CQSMnELFBWXi67tjoSeT/ITwehwuftM/W8ldWYTAFnW3DcBNvP 5xv4aSw+N0zE8OC6BnWc4499Moz6TNwGcEemSvA4nHEi9neCW1w+WirOG1ngInCJeLVk Ygzw== X-Gm-Message-State: AOJu0Yx8heb8jEXwMt3lZNkez33yM9GC6qyboCWzuQYet9tZMeGrFEL0 ohfFO4CnLXlpgx4dwJ8VcF1NXsXXleaYC2MZ3tEXmwK0spbNHBFTpxwaxS7Jnw== X-Gm-Gg: ASbGncuexlb1VHHrNt8XgJUjCSLpXUHZ9IHly4CYGUyCVddvIfR81BWD+FmZFXUdUGe BieXL46KsKDMziRnN0SqsWa4PKrZXuvFDOItfAYRZGfEgOfEpTlM8ogswaoYzhH03bbvD/Yq+DS VoSxrc+4iV38MdQh27Qg1oNXPmiOMAg/cjMRxZ/s8NaeRUwEF1UvbLkAw0yRS7WtXXj/LEhp2Bt 8RgHBtpEI1VLAqsJsWZtP5jCLa/4Y7wKoslz2oVGBDSZOByVBm/Wj7zH0bCT5HUmtDMqqNRrrD1 tZ09IJFVAzMIjLKP60rGg8gm/ol9l9haeiDWO7m5QNDLlPWOgf8NGSjY5GtQhSWFbEf1TgFGXu8 M79oeA2rTa5kF+/mhfJ2NNW3SfQ43yPvnCYHMRMRrVrdy X-Google-Smtp-Source: AGHT+IGDyVlxN9dwu46qG/0mxCbsyFgf5eN5T82iIFjp2lnmaxMsItLkVswpdJb47rd5q/8wcgAAAg== X-Received: by 2002:a05:600c:528c:b0:450:cfa7:5ea1 with SMTP id 5b1f17b1804b1-45381b0f409mr29217035e9.16.1750855875395; Wed, 25 Jun 2025 05:51:15 -0700 (PDT) Received: from christian--20230123--2G7D3 (176-138-135-207.abo.bbox.fr. [176.138.135.207]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-45382349548sm19446905e9.10.2025.06.25.05.51.14 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 25 Jun 2025 05:51:14 -0700 (PDT) From: Christian Couder To: git@vger.kernel.org Cc: Junio C Hamano , Patrick Steinhardt , Taylor Blau , Karthik Nayak , Justin Tobler , Christian Couder , Christian Couder Subject: [PATCH v5 2/5] promisor-remote: allow a server to advertise more fields Date: Wed, 25 Jun 2025 14:50:52 +0200 Message-ID: <20250625125055.1375596-3-christian.couder@gmail.com> X-Mailer: git-send-email 2.50.0.86.g149b275 In-Reply-To: <20250625125055.1375596-1-christian.couder@gmail.com> References: <20250611134506.2975856-1-christian.couder@gmail.com> <20250625125055.1375596-1-christian.couder@gmail.com> Precedence: bulk X-Mailing-List: git@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit For now the "promisor-remote" protocol capability can only pass "name" and "url" information from a server to a client in the form "name=,url=". Let's make it possible to pass more information by introducing a new "promisor.sendFields" configuration variable. This variable should contain a comma or space separated list of field names that will be looked up in the configuration of the remote on the server to find the values that will be passed to the client. Only a set of predefined fields are allowed. The only fields in this set are "partialCloneFilter" and "token". The "partialCloneFilter" field specifies the filter definition used by the promisor remote, and the "token" field can provide an authentication credential for accessing it. For example, if "promisor.sendFields" is set to "partialCloneFilter", and the server has the "remote..partialCloneFilter" config variable set to a value for a remote, then that value will be passed in the form "partialCloneFilter=" after the "name" and "url" fields. A following commit will allow the client to use the information to decide if it accepts the remote or not. For now the client doesn't do anything with the additional information it receives. Signed-off-by: Christian Couder --- Documentation/config/promisor.adoc | 22 +++++ Documentation/gitprotocol-v2.adoc | 59 +++++++++--- promisor-remote.c | 134 ++++++++++++++++++++++++-- t/t5710-promisor-remote-capability.sh | 31 ++++++ 4 files changed, 221 insertions(+), 25 deletions(-) diff --git a/Documentation/config/promisor.adoc b/Documentation/config/promisor.adoc index 2638b01f83..beb8f65518 100644 --- a/Documentation/config/promisor.adoc +++ b/Documentation/config/promisor.adoc @@ -9,6 +9,28 @@ promisor.advertise:: "false", which means the "promisor-remote" capability is not advertised. +promisor.sendFields:: + A comma or space separated list of additional remote related + field names. A server will send these field names and the + associated field values from its configuration when + advertising its promisor remotes using the "promisor-remote" + capability, see linkgit:gitprotocol-v2[5]. Currently, only the + "partialCloneFilter" and "token" field names are supported. ++ +* "partialCloneFilter": contains the partial clone filter + used for the remote. ++ +* "token": contains an authentication token for the remote. ++ +When a field name is part of this list and a corresponding +"remote.foo." config variable is set on the server to a +non-empty value, then the field name and value will be sent when +advertising the promisor remote "foo". ++ +This list has no effect unless the "promisor.advertise" config +variable is set to "true", and the "name" and "url" fields are always +advertised regardless of this setting. + promisor.acceptFromServer:: If set to "all", a client will accept all the promisor remotes a server might advertise using the "promisor-remote" diff --git a/Documentation/gitprotocol-v2.adoc b/Documentation/gitprotocol-v2.adoc index 9a57005d77..0583fafa09 100644 --- a/Documentation/gitprotocol-v2.adoc +++ b/Documentation/gitprotocol-v2.adoc @@ -785,33 +785,59 @@ retrieving the header from a bundle at the indicated URI, and thus save themselves and the server(s) the request(s) needed to inspect the headers of that bundle or bundles. -promisor-remote= +promisor-remote= ~~~~~~~~~~~~~~~~~~~~~~~~~~ The server may advertise some promisor remotes it is using or knows about to a client which may want to use them as its promisor remotes, -instead of this repository. In this case should be of the +instead of this repository. In this case should be of the form: - pr-infos = pr-info | pr-infos ";" pr-info + pr-info = pr-fields | pr-info ";" pr-info - pr-info = "name=" pr-name | "name=" pr-name "," "url=" pr-url + pr-fields = field-name "=" field-value | pr-fields "," pr-fields -where `pr-name` is the urlencoded name of a promisor remote, and -`pr-url` the urlencoded URL of that promisor remote. +where all the `field-name` and `field-value` in a given `pr-fields` +are field names and values related to a single promisor remote. -In this case, if the client decides to use one or more promisor -remotes the server advertised, it can reply with -"promisor-remote=" where should be of the form: +The server MUST advertise at least the "name" and "url" field names +along with the associated field values, which are the name of a valid +remote and its URL, in each `pr-fields`. The "name" and "url" fields +MUST appear first in each pr-fields, in that order. - pr-names = pr-name | pr-names ";" pr-name +After these mandatory fields, the server MAY advertise the following +optional fields in any order: + +- "partialCloneFilter": The filter specification used by the remote. +Clients can use this to determine if the remote's filtering strategy +is compatible with their needs (e.g., checking if both use "blob:none"). +It corresponds to the "remote..partialCloneFilter" config setting. + +- "token": An authentication token that clients can use when +connecting to the remote. It corresponds to the "remote..token" +config setting. + +No other fields are defined by the protocol at this time. Clients MUST +ignore fields they don't recognize to allow for future protocol +extensions. + +For now, the client can only use information transmitted through these +fields to decide if it accepts the advertised promisor remote. In the +future that information might be used for other purposes though. + +Field values MUST be urlencoded. + +If the client decides to use one or more promisor remotes the server +advertised, it can reply with "promisor-remote=" where + should be of the form: + + pr-names = pr-name | pr-names ";" pr-names where `pr-name` is the urlencoded name of a promisor remote the server advertised and the client accepts. -Note that, everywhere in this document, `pr-name` MUST be a valid -remote name, and the ';' and ',' characters MUST be encoded if they -appear in `pr-name` or `pr-url`. +Note that, everywhere in this document, the ';' and ',' characters +MUST be encoded if they appear in `pr-name` or `field-value`. If the server doesn't know any promisor remote that could be good for a client to use, or prefers a client not to use any promisor remote it @@ -822,9 +848,10 @@ In this case, or if the client doesn't want to use any promisor remote the server advertised, the client shouldn't advertise the "promisor-remote" capability at all in its reply. -The "promisor.advertise" and "promisor.acceptFromServer" configuration -options can be used on the server and client side to control what they -advertise or accept respectively. See the documentation of these +On the server side, the "promisor.advertise" and "promisor.sendFields" +configuration options can be used to control what it advertises. On +the client side, the "promisor.acceptFromServer" configuration option +can be used to control what it accepts. See the documentation of these configuration options for more information. Note that in the future it would be nice if the "promisor-remote" diff --git a/promisor-remote.c b/promisor-remote.c index 1cc614701b..ddb9514de0 100644 --- a/promisor-remote.c +++ b/promisor-remote.c @@ -314,6 +314,80 @@ static int allow_unsanitized(char ch) return ch > 32 && ch < 127; } +static const char promisor_field_filter[] = "partialCloneFilter"; +static const char promisor_field_token[] = "token"; + +/* + * List of optional field names that can be used in the + * "promisor-remote" protocol capability (others must be + * ignored). Each field should correspond to a configurable property + * of a remote that can be relevant for the client. + */ +static const char *known_fields[] = { + promisor_field_filter, /* Filter used for partial clone */ + promisor_field_token, /* Authentication token for the remote */ + NULL +}; + +/* + * Check if 'field' is in the list of the known field names for the + * "promisor-remote" protocol capability. + */ +static int is_known_field(const char *field) +{ + const char **p; + + for (p = known_fields; *p; p++) + if (!strcasecmp(*p, field)) + return 1; + return 0; +} + +static int is_valid_field(struct string_list_item *item, void *cb_data) +{ + const char *field = item->string; + const char *config_key = (const char *)cb_data; + + if (!is_known_field(field)) { + warning(_("unsupported field '%s' in '%s' config"), field, config_key); + return 0; + } + return 1; +} + +static char *fields_from_config(struct string_list *fields_list, const char *config_key) +{ + char *fields = NULL; + + if (!git_config_get_string(config_key, &fields) && *fields) { + /* Split on any comma or space character */ + string_list_split_in_place(fields_list, fields, ", ", -1); + /* + * Remove empty items that might result from trailing + * commas, or from items being separated by both + * commas and spaces. + */ + string_list_remove_empty_items(fields_list, 0); + filter_string_list(fields_list, 0, is_valid_field, (void *)config_key); + } + + return fields; +} + +static struct string_list *fields_sent(void) +{ + static struct string_list fields_list = STRING_LIST_INIT_NODUP; + static int initialized = 0; + + if (!initialized) { + fields_list.cmp = strcasecmp; + fields_from_config(&fields_list, "promisor.sendFields"); + initialized = 1; + } + + return &fields_list; +} + /* * Struct for promisor remotes involved in the "promisor-remote" * protocol capability. @@ -326,6 +400,8 @@ static int allow_unsanitized(char ch) struct promisor_info { const char *name; const char *url; + const char *filter; + const char *token; }; static void promisor_info_list_clear(struct string_list *list) @@ -334,15 +410,47 @@ static void promisor_info_list_clear(struct string_list *list) struct promisor_info *p = list->items[i].util; free((char *)p->name); free((char *)p->url); + free((char *)p->filter); + free((char *)p->token); } string_list_clear(list, 1); } +static void set_one_field(struct promisor_info *p, + const char *field, const char *value) +{ + if (!strcasecmp(field, promisor_field_filter)) + p->filter = xstrdup(value); + else if (!strcasecmp(field, promisor_field_token)) + p->token = xstrdup(value); + else + BUG("invalid field '%s'", field); +} + +static void set_fields(struct promisor_info *p, + struct string_list *field_names) +{ + struct string_list_item *item; + + for_each_string_list_item(item, field_names) { + char *key = xstrfmt("remote.%s.%s", p->name, item->string); + const char *val; + if (!git_config_get_string_tmp(key, &val) && *val) + set_one_field(p, item->string, val); + free(key); + } +} + /* * Populate 'list' with promisor remote information from the config. - * The 'util' pointer of each list item will hold a 'struct promisor_info'. + * The 'util' pointer of each list item will hold a 'struct + * promisor_info'. Except "name" and "url", only members of that + * struct specified by the 'field_names' list are set (using values + * from the configuration). */ -static void promisor_config_info_list(struct repository *repo, struct string_list *list) +static void promisor_config_info_list(struct repository *repo, + struct string_list *list, + struct string_list *field_names) { struct promisor_remote *r; @@ -360,6 +468,9 @@ static void promisor_config_info_list(struct repository *repo, struct string_lis new_info->name = xstrdup(r->name); new_info->url = xstrdup(url); + if (field_names) + set_fields(new_info, field_names); + item = string_list_append(list, new_info->name); item->util = new_info; } @@ -380,7 +491,7 @@ char *promisor_remote_info(struct repository *repo) if (!advertise_promisors) return NULL; - promisor_config_info_list(repo, &config_info); + promisor_config_info_list(repo, &config_info, fields_sent()); if (!config_info.nr) return NULL; @@ -395,6 +506,15 @@ char *promisor_remote_info(struct repository *repo) strbuf_addstr_urlencode(&sb, p->name, allow_unsanitized); strbuf_addstr(&sb, ",url="); strbuf_addstr_urlencode(&sb, p->url, allow_unsanitized); + + if (p->filter) { + strbuf_addf(&sb, ",%s=", promisor_field_filter); + strbuf_addstr_urlencode(&sb, p->filter, allow_unsanitized); + } + if (p->token) { + strbuf_addf(&sb, ",%s=", promisor_field_token); + strbuf_addstr_urlencode(&sb, p->token, allow_unsanitized); + } } promisor_info_list_clear(&config_info); @@ -479,7 +599,7 @@ static void filter_promisor_remote(struct repository *repo, return; if (accept != ACCEPT_ALL) { - promisor_config_info_list(repo, &config_info); + promisor_config_info_list(repo, &config_info, NULL); string_list_sort(&config_info); } @@ -498,13 +618,9 @@ static void filter_promisor_remote(struct repository *repo, elems = strbuf_split(remotes[i], ','); for (size_t j = 0; elems[j]; j++) { - int res; strbuf_strip_suffix(elems[j], ","); - res = skip_prefix(elems[j]->buf, "name=", &remote_name) || + if (!skip_prefix(elems[j]->buf, "name=", &remote_name)) skip_prefix(elems[j]->buf, "url=", &remote_url); - if (!res) - warning(_("unknown element '%s' from remote info"), - elems[j]->buf); } if (remote_name) diff --git a/t/t5710-promisor-remote-capability.sh b/t/t5710-promisor-remote-capability.sh index cb061b1f35..204528b2e0 100755 --- a/t/t5710-promisor-remote-capability.sh +++ b/t/t5710-promisor-remote-capability.sh @@ -295,6 +295,37 @@ test_expect_success "clone with 'KnownUrl' and empty url, so not advertised" ' check_missing_objects server 1 "$oid" ' +test_expect_success "clone with promisor.sendFields" ' + git -C server config promisor.advertise true && + test_when_finished "rm -rf client" && + + git -C server remote add otherLop "https://invalid.invalid" && + git -C server config remote.otherLop.token "fooBar" && + git -C server config remote.otherLop.stuff "baz" && + git -C server config remote.otherLop.partialCloneFilter "blob:limit=10k" && + test_when_finished "git -C server remote remove otherLop" && + test_config -C server promisor.sendFields "partialCloneFilter, token" && + test_when_finished "rm trace" && + + # Clone from server to create a client + GIT_TRACE_PACKET="$(pwd)/trace" GIT_NO_LAZY_FETCH=0 git clone \ + -c remote.lop.promisor=true \ + -c remote.lop.fetch="+refs/heads/*:refs/remotes/lop/*" \ + -c remote.lop.url="file://$(pwd)/lop" \ + -c promisor.acceptfromserver=All \ + --no-local --filter="blob:limit=5k" server client && + + # Check that fields are properly transmitted + ENCODED_URL=$(echo "file://$(pwd)/lop" | sed -e "s/ /%20/g") && + PR1="name=lop,url=$ENCODED_URL,partialCloneFilter=blob:none" && + PR2="name=otherLop,url=https://invalid.invalid,partialCloneFilter=blob:limit=10k,token=fooBar" && + test_grep "clone< promisor-remote=$PR1;$PR2" trace && + test_grep "clone> promisor-remote=lop;otherLop" trace && + + # Check that the largest object is still missing on the server + check_missing_objects server 1 "$oid" +' + test_expect_success "clone with promisor.advertise set to 'true' but don't delete the client" ' git -C server config promisor.advertise true && -- 2.50.0.2.g875523421d