1 <?xml version="1.0" encoding="UTF-8"?>
\r
2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
\r
4 <article lang="en" id="git-shell(1)">
\r
6 <title>git-shell(1)</title>
\r
8 <primary>git-shell(1)</primary>
\r
11 <simplesect id="_name">
\r
13 <simpara>git-shell - Restricted login shell for Git-only SSH access</simpara>
\r
15 <simplesect id="_synopsis">
\r
16 <title>SYNOPSIS</title>
\r
18 <literallayout><emphasis>git shell</emphasis> [-c <command> <argument>]</literallayout>
\r
21 <simplesect id="_description">
\r
22 <title>DESCRIPTION</title>
\r
23 <simpara>A login shell for SSH accounts to provide restricted Git access. When
\r
24 <emphasis>-c</emphasis> is given, the program executes <command> non-interactively;
\r
25 <command> can be one of <emphasis>git receive-pack</emphasis>, <emphasis>git upload-pack</emphasis>, <emphasis>git
\r
26 upload-archive</emphasis>, <emphasis>cvs server</emphasis>, or a command in COMMAND_DIR. The shell
\r
27 is started in interactive mode when no arguments are given; in this
\r
28 case, COMMAND_DIR must exist, and any of the executables in it can be
\r
30 <simpara><emphasis>cvs server</emphasis> is a special command which executes git-cvsserver.</simpara>
\r
31 <simpara>COMMAND_DIR is the path "$HOME/git-shell-commands". The user must have
\r
32 read and execute permissions to the directory in order to execute the
\r
33 programs in it. The programs are executed with a cwd of $HOME, and
\r
34 <argument> is parsed as a command-line string.</simpara>
\r
36 <simplesect id="_git">
\r
38 <simpara>Part of the <xref linkend="git(1)" /> suite</simpara>
\r