-
Notifications
You must be signed in to change notification settings - Fork 658
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add explanation of using ssh to clone submodules.
As another workaround for connection problems.
- Loading branch information
Showing
2 changed files
with
25 additions
and
4 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -98,11 +98,32 @@ the tens of kB/s, or fatal timeout errors occurring, these may be due to | |
network routing issues to github within your ISP's internal network, rather | ||
than anything wrong in your own networking setup. | ||
It can be very difficult to get ISPs to acknowledge such problems exist much | ||
less to fix them. In this case, consider trying the clone while running a | ||
VPN service. | ||
It can be very difficult to get ISPs to acknowledge such problems exist, much | ||
less to fix them. | ||
One workaround is to switch the repository to use ssh protocol prior to the | ||
submodule download, which can be done via e.g. | ||
[source,sh] | ||
---- | ||
git clone [email protected]:KhronosGroup/Vulkan-Samples.git | ||
cd Vulkan-Samples | ||
perl -i -p -e 's|https://(.*?)/|git@\1:|g' .gitmodules | ||
git submodule sync | ||
git submodule update | ||
---- | ||
While this can be a good alternative if you are running into this connection | ||
issue, you must have GitHub ssh key authentication setup to use ssh | ||
protocol - see | ||
link:https://docs.github.com/en/authentication/connecting-to-github-with-ssh[Connecting | ||
to GitHub with SSH] for details. | ||
So it is a not a solution we can implement as the repository default. | ||
Another option which may help is to run github through a VPN service. | ||
==== | ||
|
||
|
||
== Build | ||
|
||
=== Supported Platforms | ||
|
Submodule vulkan
updated
35 files