.TH HG-SSH 8 2008-01-03
.SH NAME
hg-ssh \- restricted ssh login shell for Mercurial
.SH SYNOPSIS
.B hg-ssh
.IR repositories ...
.SH DESCRIPTION
.B hg-ssh
can be used as a restricted shell where access to Mercurial repositories is given over
.BR ssh (1).
It should be specified, together with the paths to the
.I repositories
the user should be given access to, as a
.I command
option in an
.BR authorized_keys (5)
file.
.PP
An example
.I authorized_keys
line using
.BR hg-ssh :
.RS
command="hg-ssh path/to/repo1 /path/to/repo2 ~/repo3 ~user/repo4"
ssh-rsa AA...==
.RE
.PP
The user with the specified key would then be permitted to push and pull to the repositories using the URLs:
.RS
.nf
ssh://example.com/path/to/repo1
ssh://example.com//path/to/repo2
ssh://example.com/~/repo3
ssh://example.com/~user/repo4
.fi
.RE
.SH SEE ALSO
.BR sshd (8),
.BR ssh (1),
.BR hg (1).