|
1 ======== |
|
2 hg-ssh |
|
3 ======== |
|
4 |
|
5 ---------------------------------------- |
|
6 restricted ssh login shell for Mercurial |
|
7 ---------------------------------------- |
|
8 |
|
9 :Author: Thomas Arendsen Hein <thomas@intevation.de> |
|
10 :Organization: Mercurial |
|
11 :Manual section: 8 |
|
12 :Manual group: Mercurial Manual |
|
13 |
|
14 .. contents:: |
|
15 :backlinks: top |
|
16 :class: htmlonly |
|
17 :depth: 1 |
|
18 |
|
19 Synopsis |
|
20 """""""" |
|
21 **hg-ssh** repositories... |
|
22 |
|
23 Description |
|
24 """"""""""" |
|
25 **hg-ssh** is a wrapper for ssh access to a limited set of mercurial repos. |
|
26 |
|
27 To be used in ~/.ssh/authorized_keys with the "command" option, see sshd(8): |
|
28 command="hg-ssh path/to/repo1 /path/to/repo2 ~/repo3 ~user/repo4" ssh-dss ... |
|
29 (probably together with these other useful options: |
|
30 no-port-forwarding,no-X11-forwarding,no-agent-forwarding) |
|
31 |
|
32 This allows pull/push over ssh from/to the repositories given as arguments. |
|
33 |
|
34 If all your repositories are subdirectories of a common directory, you can |
|
35 allow shorter paths with: |
|
36 command="cd path/to/my/repositories && hg-ssh repo1 subdir/repo2" |
|
37 |
|
38 You can use pattern matching of your normal shell, e.g.: |
|
39 command="cd repos && hg-ssh user/thomas/* projects/{mercurial,foo}" |
|
40 |
|
41 You can also add a --read-only flag to allow read-only access to a key, e.g.: |
|
42 command="hg-ssh --read-only repos/\*" |
|
43 |
|
44 Bugs |
|
45 """" |
|
46 Probably lots, please post them to the mailing list (see Resources_ |
|
47 below) when you find them. |
|
48 |
|
49 See Also |
|
50 """""""" |
|
51 |hg(1)|_ |
|
52 |
|
53 Author |
|
54 """""" |
|
55 Written by Matt Mackall <mpm@selenic.com> |
|
56 |
|
57 Resources |
|
58 """"""""" |
|
59 Main Web Site: https://mercurial-scm.org/ |
|
60 |
|
61 Source code repository: https://www.mercurial-scm.org/repo/hg |
|
62 |
|
63 Mailing list: https://www.mercurial-scm.org/mailman/listinfo/mercurial/ |
|
64 |
|
65 Copying |
|
66 """"""" |
|
67 Copyright (C) 2005-2016 Matt Mackall. |
|
68 Free use of this software is granted under the terms of the GNU General |
|
69 Public License version 2 or any later version. |
|
70 |
|
71 .. include:: common.txt |