2010-12-30 20:52:24 +00:00
|
|
|
# NAME
|
|
|
|
|
|
|
|
|
|
git-annex-shell - Restricted login shell for git-annex only SSH access
|
|
|
|
|
|
|
|
|
|
# SYNOPSIS
|
|
|
|
|
|
2010-12-31 00:08:22 +00:00
|
|
|
git-annex-shell [-c] command [params ...]
|
2010-12-30 20:52:24 +00:00
|
|
|
|
|
|
|
|
# DESCRIPTION
|
|
|
|
|
|
2010-12-31 00:08:22 +00:00
|
|
|
git-annex-shell is a restricted shell, similar to git-shell, which
|
|
|
|
|
can be used as a login shell for SSH accounts.
|
2010-12-30 20:52:24 +00:00
|
|
|
|
2011-03-04 01:55:56 +00:00
|
|
|
Since its syntax is identical to git-shell's, it can be used as a drop-in
|
|
|
|
|
replacement anywhere git-shell is used. For example it can be used as a
|
|
|
|
|
user's restricted login shell.
|
|
|
|
|
|
2010-12-30 20:52:24 +00:00
|
|
|
# COMMANDS
|
|
|
|
|
|
2011-04-09 18:15:38 +00:00
|
|
|
Any command not listed below is passed through to git-shell.
|
|
|
|
|
|
2011-10-15 23:06:35 +00:00
|
|
|
Note that the directory parameter should be an absolute path, otherwise
|
|
|
|
|
it is assumed to be relative to the user's home directory. Also the
|
|
|
|
|
first "/~/" or "/~user/" is expanded to the specified home directory.
|
|
|
|
|
|
2010-12-31 00:08:22 +00:00
|
|
|
* configlist directory
|
2010-12-30 20:52:24 +00:00
|
|
|
|
2011-03-04 01:55:56 +00:00
|
|
|
This outputs a subset of the git configuration, in the same form as
|
2010-12-31 00:08:22 +00:00
|
|
|
`git config --list`
|
2010-12-30 20:52:24 +00:00
|
|
|
|
2010-12-31 00:08:22 +00:00
|
|
|
* inannex directory [key ...]
|
2010-12-30 20:52:24 +00:00
|
|
|
|
2010-12-31 00:08:22 +00:00
|
|
|
This checks if all specified keys are present in the annex,
|
|
|
|
|
and exits zero if so.
|
2010-12-30 20:52:24 +00:00
|
|
|
|
2010-12-31 00:08:22 +00:00
|
|
|
* dropkey directory [key ...]
|
2010-12-30 20:52:24 +00:00
|
|
|
|
2010-12-31 00:08:22 +00:00
|
|
|
This drops the annexed data for the specified keys.
|
2010-12-30 20:52:24 +00:00
|
|
|
|
2010-12-31 00:08:22 +00:00
|
|
|
* recvkey directory key
|
2010-12-30 20:52:24 +00:00
|
|
|
|
2010-12-31 00:08:22 +00:00
|
|
|
This runs rsync in server mode to receive the content of a key,
|
|
|
|
|
and stores the content in the annex.
|
2010-12-30 20:52:24 +00:00
|
|
|
|
2010-12-31 00:08:22 +00:00
|
|
|
* sendkey directory key
|
2010-12-30 20:52:24 +00:00
|
|
|
|
2010-12-31 00:08:22 +00:00
|
|
|
This runs rsync in server mode to transfer out the content of a key.
|
2010-12-30 20:52:24 +00:00
|
|
|
|
2012-09-22 03:25:06 +00:00
|
|
|
* transferinfo directory key
|
2012-09-21 20:23:25 +00:00
|
|
|
|
|
|
|
|
This is typically run at the same time as sendkey is sending a key
|
2012-09-22 03:25:06 +00:00
|
|
|
to the remote. Using it is optional, but is used to update
|
|
|
|
|
progress information for the transfer of the key.
|
2012-09-21 20:23:25 +00:00
|
|
|
|
|
|
|
|
It reads lines from standard input, each giving the number of bytes
|
2012-09-22 03:25:06 +00:00
|
|
|
that have been received so far.
|
2012-09-21 20:23:25 +00:00
|
|
|
|
2012-06-24 21:51:08 +00:00
|
|
|
* commit directory
|
2012-02-25 20:31:38 +00:00
|
|
|
|
|
|
|
|
This commits any staged changes to the git-annex branch.
|
2012-03-14 16:01:56 +00:00
|
|
|
It also runs the annex-content hook.
|
2012-02-25 20:31:38 +00:00
|
|
|
|
2011-05-14 16:26:06 +00:00
|
|
|
# OPTIONS
|
2011-04-09 18:15:38 +00:00
|
|
|
|
2011-10-15 23:06:35 +00:00
|
|
|
Most options are the same as in git-annex. The ones specific
|
|
|
|
|
to git-annex-shell are:
|
2011-04-09 18:15:38 +00:00
|
|
|
|
2011-10-15 23:06:35 +00:00
|
|
|
* --uuid=UUID
|
|
|
|
|
|
|
|
|
|
git-annex uses this to specify the UUID of the repository it was expecting
|
|
|
|
|
git-annex-shell to access, as a sanity check.
|
|
|
|
|
|
2012-07-02 04:53:00 +00:00
|
|
|
* -- fields=val fields=val.. --
|
|
|
|
|
|
|
|
|
|
Additional fields may be specified this way, to retain compatability with
|
|
|
|
|
past versions of git-annex-shell (that ignore these, but would choke
|
|
|
|
|
on new dashed options).
|
|
|
|
|
|
|
|
|
|
Currently used fields include remoteuuid= and associatedfile=
|
|
|
|
|
|
2012-03-14 16:01:56 +00:00
|
|
|
# HOOK
|
|
|
|
|
|
|
|
|
|
After content is received or dropped from the repository by git-annex-shell,
|
|
|
|
|
it runs a hook, `.git/hooks/annex-content` (or `hooks/annex-content` on a bare
|
|
|
|
|
repository). The hook is not currently passed any information about what
|
|
|
|
|
changed.
|
|
|
|
|
|
2011-10-15 23:06:35 +00:00
|
|
|
# ENVIRONMENT
|
|
|
|
|
|
|
|
|
|
* GIT_ANNEX_SHELL_READONLY
|
|
|
|
|
|
|
|
|
|
If set, disallows any command that could modify the repository.
|
|
|
|
|
|
|
|
|
|
* GIT_ANNEX_SHELL_LIMITED
|
|
|
|
|
|
|
|
|
|
If set, disallows running git-shell to handle unknown commands.
|
2011-01-04 21:33:24 +00:00
|
|
|
|
2012-11-05 15:29:12 +00:00
|
|
|
* GIT_ANNEX_SHELL_DIRECTORY
|
|
|
|
|
|
|
|
|
|
If set, git-annex-shell will refuse to run commands that do not operate
|
|
|
|
|
on the specified directory.
|
|
|
|
|
|
2010-12-30 20:52:24 +00:00
|
|
|
# SEE ALSO
|
|
|
|
|
|
|
|
|
|
[[git-annex]](1)
|
|
|
|
|
|
|
|
|
|
git-shell(1)
|
|
|
|
|
|
|
|
|
|
# AUTHOR
|
|
|
|
|
|
|
|
|
|
Joey Hess <joey@kitenet.net>
|
|
|
|
|
|
|
|
|
|
<http://git-annex.branchable.com/>
|
|
|
|
|
|
2011-12-07 17:17:00 +00:00
|
|
|
Warning: Automatically converted into a man page by mdwn2man. Edit with care
|
