2 .\" Copyright (c) 2023 Stefan Sperling
4 .\" Permission to use, copy, modify, and distribute this software for any
5 .\" purpose with or without fee is hereby granted, provided that the above
6 .\" copyright notice and this permission notice appear in all copies.
8 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
9 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
11 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
14 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
21 .Nd invoke an appropriate Git repository server
23 .Nm Fl c Sq Cm git-receive-pack Ar repository-path
24 .Nm Fl c Sq Cm git-upload-pack Ar repository-path
26 At one time, the only Git repository server software easily available
30 .Xr git-receive-pack 1
34 As a result of this, most Git client implementations had the path and
35 calling conventions expected by
39 Times have changed, however.
40 On a modern system, the administrator may wish to use one of several
41 available Git repository servers, such as
44 It would be difficult to modify all Git client software typically available
45 on a system, so most of the authors of alternative Git servers have written
46 their programs so that they use the same calling conventions as
49 .Xr git-receive-pack 1
50 and may be put into place in their stead.
52 Although having drop-in replacements for
55 .Xr git-receive-pack 1
56 helps in installing alternative Git servers, it essentially makes the
57 configuration of the system depend on hard installing new programs in
59 This leads to configuration problems for many administrators, since they may
60 wish to install a new Git server without altering the system provided
62 (This may be, for example, to avoid having upgrade problems when a new
63 version of the system is installed over the old.)
64 They may also have a shared
66 among several machines, and may wish to avoid placing implicit
67 configuration information in a read-only
72 program is designed to replace
75 .Xr git-receive-pack 1
76 and to invoke an appropriate Git server based on configuration information
79 This permits the administrator to configure which Git server is to be
80 invoked on the system at run-time.
81 Git repositories which are listed in
83 and exist on the filesystem will be served by
85 Any other Git repositories will be served by
88 .Xr git-receive-pack 1 .
90 .Bl -tag -width GOTD_CONF_PATH
92 Set the path to the configuration file for
94 If not specified, the default path
107 are typically set up as a symlink to
109 which is not usually invoked on its own.
116 .An Stefan Sperling Aq Mt stsp@openbsd.org
118 The entire reason this program exists is a crock.
119 Instead, a command for invoking a Git server should be standardized or
120 the Git protocol should be changed to make the path to the program
121 discoverable by Git clients.