Re: [PATCH] Documentation for git-shell
From: Petr Baudis <hidden>
Date: 2016-06-15 22:42:09
Subsystem:
documentation, the rest · Maintainers:
Jonathan Corbet, Linus Torvalds
Possibly related (same subject, not in this thread)
- 2016-06-15 · [PATCH] Documentation for git-shell · Petr Baudis <hidden>
Dear diary, on Tue, Oct 25, 2005 at 06:57:06PM CEST, I got a letter where Junio C Hamano [off-list ref] told me that...
Thanks. I'd leave the door open for possibility of future command additions by saying what *kind* of things it is meant to allow spawning first and then listing what commands we *currently* allow next. Also we need a link to this in either Ancillary (in which subsection I am not sure of, though) or Synching repository section of git.txt.
Done. --- [PATCH] Documentation for git-shell This adds some simple documentation for git-shell. Signed-off-by: Petr Baudis <redacted> --- Documentation/git-shell.txt | 35 +++++++++++++++++++++++++++++++++++ Documentation/git.txt | 3 +++ 2 files changed, 38 insertions(+), 0 deletions(-)
diff --git a/Documentation/git-shell.txt b/Documentation/git-shell.txt
new file mode 100644
index 0000000..3f4d804
--- /dev/null
+++ b/Documentation/git-shell.txt@@ -0,0 +1,35 @@ +git-shell(1) +============ + +NAME +---- +git-shell - Restricted login shell for GIT over SSH only + + +SYNOPSIS +-------- +'git-shell -c <command> <argument>' + +DESCRIPTION +----------- +This is meant to be used as a login shell for SSH accounts you want +to restrict to GIT pull/push access only. It permits execution only +of server-side GIT commands implementing the pull/push functionality. +The commands can be executed only by the '-c' option; the shell is not +interactive. + +Currently, only the `git-receive-pack` and `git-upload-pack` commands +are permitted to be called, with a single required argument. + +Author +------ +Written by Linus Torvalds <torvalds@osdl.org> + +Documentation +-------------- +Documentation by Petr Baudis and the git-list <git@vger.kernel.org>. + +GIT +--- +Part of the gitlink:git[7] suite +
diff --git a/Documentation/git.txt b/Documentation/git.txt
index 796c4f6..769054b 100644
--- a/Documentation/git.txt
+++ b/Documentation/git.txt@@ -182,6 +182,9 @@ gitlink:git-receive-pack[1]:: gitlink:git-send-pack[1]:: Pushes to a remote repository, intelligently. +gitlink:git-shell[1]:: + Restricted shell for GIT-only SSH access. + gitlink:git-ssh-fetch[1]:: Pulls from a remote repository over ssh connection Previously this command was known as git-ssh-pull.
--
Petr "Pasky" Baudis
Stuff: http://pasky.or.cz/
VI has two modes: the one in which it beeps and the one in which
it doesn't.