Merge branch 'jj/doc-markup-gitcli' into maint
[git] / contrib / persistent-https / README
1 git-remote-persistent-https
2
3 The git-remote-persistent-https binary speeds up SSL operations
4 by running a daemon job (git-remote-persistent-https--proxy) that
5 keeps a connection open to a server.
6
7
8 PRE-BUILT BINARIES
9
10 Darwin amd64:
11 https://commondatastorage.googleapis.com/git-remote-persistent-https/darwin_amd64.tar.gz
12
13 Linux amd64:
14 https://commondatastorage.googleapis.com/git-remote-persistent-https/linux_amd64.tar.gz
15
16
17 INSTALLING
18
19 Move all of the git-remote-persistent-http* binaries to a directory
20 in PATH.
21
22
23 USAGE
24
25 HTTPS requests can be delegated to the proxy by using the
26 "persistent-https" scheme, e.g.
27
28 git clone persistent-https://kernel.googlesource.com/pub/scm/git/git
29
30 Likewise, .gitconfig can be updated as follows to rewrite https urls
31 to use persistent-https:
32
33 [url "persistent-https"]
34         insteadof = https
35 [url "persistent-http"]
36         insteadof = http
37
38
39 #####################################################################
40 # BUILDING FROM SOURCE
41 #####################################################################
42
43 LOCATION
44
45 The source is available in the contrib/persistent-https directory of
46 the Git source repository. The Git source repository is available at
47 git://git.kernel.org/pub/scm/git/git.git/
48 https://kernel.googlesource.com/pub/scm/git/git
49
50
51 PREREQUISITES
52
53 The code is written in Go (http://golang.org/) and the Go compiler is
54 required. Currently, the compiler must be built and installed from tip
55 of source, in order to include a fix in the reverse http proxy:
56 http://code.google.com/p/go/source/detail?r=a615b796570a2cd8591884767a7d67ede74f6648
57
58
59 BUILDING
60
61 Run "make" to build the binaries. See the section on
62 INSTALLING above.