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. On a modern system, the administrator may
40 wish to use one of several available Git repository servers, such as
43 It would be difficult to modify all Git client software typically available
44 on a system, so most of the authors of alternative Git servers have written
45 their programs so that they use the same calling conventions as
48 .Xr git-receive-pack 1
49 and may be put into place in their stead.
51 Although having drop-in replacements for
54 .Xr git-receive-pack 1
55 helps in installing alternative Git servers, it essentially makes the
56 configuration of the system depend on hard installing new programs in /usr.
57 This leads to configuration problems for many administrators, since they may
58 wish to install a new Git server without altering the system provided /usr.
59 (This may be, for example, to avoid having upgrade problems when a new
60 version of the system is installed over the old.) They may also have a
61 shared /usr among several machines, and may wish to avoid placing implicit
62 configuration information in a read-only /usr.
66 program is designed to replace
69 .Xr git-receive-pack 1
70 and to invoke an appropriate Git server based on configuration information
73 This permits the administrator to configure which Git server is to be
74 invoked on the system at run-time.
75 Git repositories which are listed in
77 and exist on the filesystem will be served by
79 Any other Git repositories will be served by
82 .Xr git-receive-pack 1 .
92 are typically set up as a symlink to
94 which is not usually invoked on its own.
96 .Bl -tag -width GOTD_CONF_PATH
98 Set the path to the configuration file for
100 If not specified, the default path
110 .An Stefan Sperling Aq Mt stsp@openbsd.org
112 The entire reason this program exists is a crock. Instead, a command for
113 invoking a Git server should be standardized or the Git protocol should
114 be changed to make the path to the program discoverable by Git clients.