* [PATCH] doc: bitbake-user-manual: specify the URL to be used with SSH over git is different from `git clone`'s
@ 2022-01-17 13:08 quentin.schulz
2022-01-17 15:04 ` [docs] " Quentin Schulz
0 siblings, 1 reply; 3+ messages in thread
From: quentin.schulz @ 2022-01-17 13:08 UTC (permalink / raw)
To: docs, bitbake-devel; +Cc: Quentin Schulz, Quentin Schulz
From: Quentin Schulz <quentin.schulz@theobroma-systems.com>
The URL expected by git fetcher when the SSH protocol is used differs
from the one given by Git servers to be used with the `git clone`
command.
Add a note making this specificity known to users.
Cc: Quentin Schulz <foss+yocto@0leil.net>
Signed-off-by: Quentin Schulz <quentin.schulz@theobroma-systems.com>
---
.../bitbake-user-manual-fetching.rst | 14 ++++++++++++++
1 file changed, 14 insertions(+)
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.rst b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.rst
index 0fc2d5e699..77384cfdc7 100644
--- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.rst
+++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.rst
@@ -396,6 +396,19 @@ This fetcher supports the following parameters:
protocol is "file". You can also use "http", "https", "ssh" and
"rsync".
+ .. note::
+
+ When ``protocol`` is "ssh", the URL expected in :term:`SRC_URI` differs
+ from the one that is typically passed to ``git clone`` command and provided
+ by the Git server to fetch from. For example, the URL returned by GitLab
+ server for ``mesa`` when cloning over SSH is
+ ``git@gitlab.freedesktop.org:mesa/mesa.git``, however the expected URL in
+ :term:`SRC_URI` is the following::
+
+ SRC_URI = "git://git@gitlab.freedesktop.org/mesa/mesa.git;protocol=ssh;..."
+
+ Note the ``:`` character changed for a ``/`` before the path to the project.
+
- *"nocheckout":* Tells the fetcher to not checkout source code when
unpacking when set to "1". Set this option for the URL where there is
a custom routine to checkout code. The default is "0".
@@ -446,6 +459,7 @@ Here are some example URLs::
SRC_URI = "git://git.oe.handhelds.org/git/vip.git;tag=version-1"
SRC_URI = "git://git.oe.handhelds.org/git/vip.git;protocol=http"
+ SRC_URI = "git://git@gitlab.freedesktop.org/mesa/mesa.git;protocol=ssh;..."
.. note::
--
2.34.1
^ permalink raw reply related [flat|nested] 3+ messages in thread
* Re: [docs] [PATCH] doc: bitbake-user-manual: specify the URL to be used with SSH over git is different from `git clone`'s
2022-01-17 13:08 [PATCH] doc: bitbake-user-manual: specify the URL to be used with SSH over git is different from `git clone`'s quentin.schulz
@ 2022-01-17 15:04 ` Quentin Schulz
2022-01-17 21:54 ` Richard Purdie
0 siblings, 1 reply; 3+ messages in thread
From: Quentin Schulz @ 2022-01-17 15:04 UTC (permalink / raw)
To: docs, bitbake-devel; +Cc: Quentin Schulz
Hi all,
On 1/17/22 14:08, Quentin Schulz wrote:
> From: Quentin Schulz <quentin.schulz@theobroma-systems.com>
>
> The URL expected by git fetcher when the SSH protocol is used differs
> from the one given by Git servers to be used with the `git clone`
> command.
>
> Add a note making this specificity known to users.
>
> Cc: Quentin Schulz <foss+yocto@0leil.net>
> Signed-off-by: Quentin Schulz <quentin.schulz@theobroma-systems.com>
> ---
> .../bitbake-user-manual-fetching.rst | 14 ++++++++++++++
> 1 file changed, 14 insertions(+)
>
> diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.rst b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.rst
> index 0fc2d5e699..77384cfdc7 100644
> --- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.rst
> +++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.rst
Forgot to make the patch from a subdir instead of poky root, lemme know
if I need to resend a patch.
Cheers,
Quentin
> @@ -396,6 +396,19 @@ This fetcher supports the following parameters:
> protocol is "file". You can also use "http", "https", "ssh" and
> "rsync".
>
> + .. note::
> +
> + When ``protocol`` is "ssh", the URL expected in :term:`SRC_URI` differs
> + from the one that is typically passed to ``git clone`` command and provided
> + by the Git server to fetch from. For example, the URL returned by GitLab
> + server for ``mesa`` when cloning over SSH is
> + ``git@gitlab.freedesktop.org:mesa/mesa.git``, however the expected URL in
> + :term:`SRC_URI` is the following::
> +
> + SRC_URI = "git://git@gitlab.freedesktop.org/mesa/mesa.git;protocol=ssh;..."
> +
> + Note the ``:`` character changed for a ``/`` before the path to the project.
> +
> - *"nocheckout":* Tells the fetcher to not checkout source code when
> unpacking when set to "1". Set this option for the URL where there is
> a custom routine to checkout code. The default is "0".
> @@ -446,6 +459,7 @@ Here are some example URLs::
>
> SRC_URI = "git://git.oe.handhelds.org/git/vip.git;tag=version-1"
> SRC_URI = "git://git.oe.handhelds.org/git/vip.git;protocol=http"
> + SRC_URI = "git://git@gitlab.freedesktop.org/mesa/mesa.git;protocol=ssh;..."
>
> .. note::
>
>
>
>
> -=-=-=-=-=-=-=-=-=-=-=-
> Links: You receive all messages sent to this group.
> View/Reply Online (#2416): https://urldefense.proofpoint.com/v2/url?u=https-3A__lists.yoctoproject.org_g_docs_message_2416&d=DwIFaQ&c=_sEr5x9kUWhuk4_nFwjJtA&r=LYjLexDn7rXIzVmkNPvw5ymA1XTSqHGq8yBP6m6qZZ4njZguQhZhkI_-172IIy1t&m=_l7-tAR3swWTH4C1S8UI63LA1SPlO2MekWnZZJITMwpYJava3108u83_dMFzD5LU&s=F_w0Ot9oRIjE4kXGRrG-cjdVPE5_S0uSmhOaV74rLKE&e=
> Mute This Topic: https://urldefense.proofpoint.com/v2/url?u=https-3A__lists.yoctoproject.org_mt_88483091_6293953&d=DwIFaQ&c=_sEr5x9kUWhuk4_nFwjJtA&r=LYjLexDn7rXIzVmkNPvw5ymA1XTSqHGq8yBP6m6qZZ4njZguQhZhkI_-172IIy1t&m=_l7-tAR3swWTH4C1S8UI63LA1SPlO2MekWnZZJITMwpYJava3108u83_dMFzD5LU&s=-nz5CF1CFvGdLoLVQGx84M1Jev0zSa2FHRJ-xAWXncg&e=
> Group Owner: docs+owner@lists.yoctoproject.org
> Unsubscribe: https://urldefense.proofpoint.com/v2/url?u=https-3A__lists.yoctoproject.org_g_docs_unsub&d=DwIFaQ&c=_sEr5x9kUWhuk4_nFwjJtA&r=LYjLexDn7rXIzVmkNPvw5ymA1XTSqHGq8yBP6m6qZZ4njZguQhZhkI_-172IIy1t&m=_l7-tAR3swWTH4C1S8UI63LA1SPlO2MekWnZZJITMwpYJava3108u83_dMFzD5LU&s=9I0R47Ub2WW27sRRxCqP65jf1LHTx4TU4dhRbBOu888&e= [quentin.schulz@theobroma-systems.com]
> -=-=-=-=-=-=-=-=-=-=-=-
>
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: [docs] [PATCH] doc: bitbake-user-manual: specify the URL to be used with SSH over git is different from `git clone`'s
2022-01-17 15:04 ` [docs] " Quentin Schulz
@ 2022-01-17 21:54 ` Richard Purdie
0 siblings, 0 replies; 3+ messages in thread
From: Richard Purdie @ 2022-01-17 21:54 UTC (permalink / raw)
To: Quentin Schulz, docs, bitbake-devel; +Cc: Quentin Schulz
On Mon, 2022-01-17 at 16:04 +0100, Quentin Schulz wrote:
> Hi all,
>
> On 1/17/22 14:08, Quentin Schulz wrote:
> > From: Quentin Schulz <quentin.schulz@theobroma-systems.com>
> >
> > The URL expected by git fetcher when the SSH protocol is used differs
> > from the one given by Git servers to be used with the `git clone`
> > command.
> >
> > Add a note making this specificity known to users.
> >
> > Cc: Quentin Schulz <foss+yocto@0leil.net>
> > Signed-off-by: Quentin Schulz <quentin.schulz@theobroma-systems.com>
> > ---
> > .../bitbake-user-manual-fetching.rst | 14 ++++++++++++++
> > 1 file changed, 14 insertions(+)
> >
> > diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.rst b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.rst
> > index 0fc2d5e699..77384cfdc7 100644
> > --- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.rst
> > +++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.rst
>
> Forgot to make the patch from a subdir instead of poky root, lemme know
> if I need to resend a patch.
I can handle that, merged, thanks.
Cheers,
Richard
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2022-01-17 21:54 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-01-17 13:08 [PATCH] doc: bitbake-user-manual: specify the URL to be used with SSH over git is different from `git clone`'s quentin.schulz
2022-01-17 15:04 ` [docs] " Quentin Schulz
2022-01-17 21:54 ` Richard Purdie
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.