[Emacs-diffs] /srv/bzr/emacs/trunk r108910: * tramp.texi (Multi-hops): Introduce `tramp-restricted-shell-hosts-alist'.

[Michael Albinus]

------------------------------------------------------------
revno: 108910
committer: Michael Albinus <address@hidden>
branch nick: trunk
timestamp: Fri 2012-07-06 15:19:33 +0200
message:
  * tramp.texi (Multi-hops): Introduce `tramp-restricted-shell-hosts-alist'.
modified:
  doc/misc/ChangeLog
  doc/misc/tramp.texi

=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog        2012-06-26 22:52:31 +0000
+++ b/doc/misc/ChangeLog        2012-07-06 13:19:33 +0000
@@ -1,3 +1,8 @@
+2012-07-06  Michael Albinus  <address@hidden>
+
+       * tramp.texi (Multi-hops): Introduce
+       `tramp-restricted-shell-hosts-alist'.
+
 2012-06-26  Lars Magne Ingebrigtsen  <address@hidden>
 
        * gnus.texi (POP before SMTP): POP-before-SMTP works with all sending

=== modified file 'doc/misc/tramp.texi'
--- a/doc/misc/tramp.texi       2012-06-11 13:03:39 +0000
+++ b/doc/misc/tramp.texi       2012-07-06 13:19:33 +0000
@@ -1327,19 +1327,21 @@
 @cindex multi-hop
 @cindex proxy hosts
 
-Sometimes, the methods described before are not sufficient.  Sometimes,
-it is not possible to connect to a remote host using a simple command.
-For example, if you are in a secured network, you might have to log in
-to a `bastion host' first before you can connect to the outside world.
-Of course, the target host may also require a bastion host.
+Sometimes, the methods described before are not sufficient.
+Sometimes, it is not possible to connect to a remote host using a
+simple command.  For example, if you are in a secured network, you
+might have to log in to a bastion host first before you can connect to
+the outside world.  Of course, the target host may also require a
+bastion host.
 
 @vindex tramp-default-proxies-alist
-In order to specify such multiple hops, it is possible to define a proxy
address@hidden tramp-default-proxies-alist
+In order to specify multiple hops, it is possible to define a proxy
 host to pass through, via the variable
 @code{tramp-default-proxies-alist}.  This variable keeps a list of
 triples (@var{host} @var{user} @var{proxy}).
 
- The first matching item specifies the proxy host to be passed for a
+The first matching item specifies the proxy host to be passed for a
 file name located on a remote target matching @var{user}@@@var{host}.
 @var{host} and @var{user} are regular expressions or @code{nil}, which
 is interpreted as a regular expression which always matches.
@@ -1442,6 +1444,26 @@
 Gateway methods can be declared as first hop only in a multiple hop
 chain.
 @end ifset
address@hidden defopt
+
+Hops to be passed tend to be restricted firewalls and alike.
+Sometimes they offer limited features only, like running @command{rbash}
+(restricted bash).  This must be told to @value{tramp}.
+
address@hidden tramp-restricted-shell-hosts-alist
address@hidden tramp-restricted-shell-hosts-alist
+This variable keeps a list of regular expressions, which denote hosts
+running a registered shell like "rbash".  Those hosts can be used as
+proxies only.
+
+If the bastion host from the example above runs a restricted shell,
+you shall apply
+
address@hidden
+(add-to-list 'tramp-restricted-shell-hosts-alist
+             "\\`bastion\\.your\\.domain\\'")
address@hidden lisp
address@hidden defopt
 
 
 @node Customizing Methods