diff options
Diffstat (limited to 'bitbake/doc')
-rw-r--r-- | bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.rst | 14 |
1 files changed, 14 insertions, 0 deletions
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: | |||
396 | protocol is "file". You can also use "http", "https", "ssh" and | 396 | protocol is "file". You can also use "http", "https", "ssh" and |
397 | "rsync". | 397 | "rsync". |
398 | 398 | ||
399 | .. note:: | ||
400 | |||
401 | When ``protocol`` is "ssh", the URL expected in :term:`SRC_URI` differs | ||
402 | from the one that is typically passed to ``git clone`` command and provided | ||
403 | by the Git server to fetch from. For example, the URL returned by GitLab | ||
404 | server for ``mesa`` when cloning over SSH is | ||
405 | ``git@gitlab.freedesktop.org:mesa/mesa.git``, however the expected URL in | ||
406 | :term:`SRC_URI` is the following:: | ||
407 | |||
408 | SRC_URI = "git://git@gitlab.freedesktop.org/mesa/mesa.git;protocol=ssh;..." | ||
409 | |||
410 | Note the ``:`` character changed for a ``/`` before the path to the project. | ||
411 | |||
399 | - *"nocheckout":* Tells the fetcher to not checkout source code when | 412 | - *"nocheckout":* Tells the fetcher to not checkout source code when |
400 | unpacking when set to "1". Set this option for the URL where there is | 413 | unpacking when set to "1". Set this option for the URL where there is |
401 | a custom routine to checkout code. The default is "0". | 414 | a custom routine to checkout code. The default is "0". |
@@ -446,6 +459,7 @@ Here are some example URLs:: | |||
446 | 459 | ||
447 | SRC_URI = "git://git.oe.handhelds.org/git/vip.git;tag=version-1" | 460 | SRC_URI = "git://git.oe.handhelds.org/git/vip.git;tag=version-1" |
448 | SRC_URI = "git://git.oe.handhelds.org/git/vip.git;protocol=http" | 461 | SRC_URI = "git://git.oe.handhelds.org/git/vip.git;protocol=http" |
462 | SRC_URI = "git://git@gitlab.freedesktop.org/mesa/mesa.git;protocol=ssh;..." | ||
449 | 463 | ||
450 | .. note:: | 464 | .. note:: |
451 | 465 | ||