hg-ssh(8)

1HG-SSH(8)                      Mercurial Manual                      HG-SSH(8)
2
3
4

NAME

6       hg-ssh - restricted ssh login shell for Mercurial
7

SYNOPSIS

9       hg-ssh repositories...
10

DESCRIPTION

12       hg-ssh is a wrapper for ssh access to a limited set of mercurial repos.
13
14       To  be  used  in  ~/.ssh/authorized_keys with the "command" option, see
15       sshd(8):   command="hg-ssh   path/to/repo1    /path/to/repo2    ~/repo3
16       ~user/repo4"  ssh-dss  ...   (probably together with these other useful
17       options: no-port-forwarding,no-X11-forwarding,no-agent-forwarding)
18
19       This allows pull/push over ssh from/to the repositories given as  argu‐
20       ments.
21
22       If  all your repositories are subdirectories of a common directory, you
23       can allow shorter paths with:  command="cd  path/to/my/repositories  &&
24       hg-ssh repo1 subdir/repo2"
25
26       You  can  use  pattern matching of your normal shell, e.g.: command="cd
27       repos && hg-ssh user/thomas/* projects/{mercurial,foo}"
28
29       You can also add a --read-only flag to allow read-only access to a key,
30       e.g.: command="hg-ssh --read-only repos/*"
31

BUGS

33       Probably  lots,  please  post  them  to the mailing list (see Resources
34       below) when you find them.
35

AUTHOR

40       Written by Olivia Mackall <olivia@selenic.com>
41

RESOURCES

43       Main Web Site: https://mercurial-scm.org/
44
45       Source code repository: https://www.mercurial-scm.org/repo/hg
46
47       Mailing list: https://www.mercurial-scm.org/mailman/listinfo/mercurial/
48

COPYING

50       Copyright  (C)  2005-2016 Olivia Mackall.  Free use of this software is
51       granted under the terms of the GNU General Public License version 2  or
52       any later version.
53

AUTHOR

55       Thomas Arendsen Hein <thomas@intevation.de>
56
57       Organization: Mercurial
58
59
60
61
62                                                                     HG-SSH(8)