[Emacs-diffs] /srv/bzr/emacs/trunk r111808: * tramp.texi (Top, Configuration): Insert section `Android shell

[Michael Albinus]

------------------------------------------------------------
revno: 111808
committer: Michael Albinus <address@hidden>
branch nick: trunk
timestamp: Sat 2013-02-16 18:38:37 +0100
message:
  * tramp.texi (Top, Configuration): Insert section `Android shell
  setup' in menu.
  (Android shell setup): New section.
  (Connection types, Default Method)
  (Frequently Asked Questions): Mention "scp" instead of "scpc".
  (External methods): Remove "scpc" and "rsyncc" entries.
  (Frequently Asked Questions): Remove entry about ControlPersist.
modified:
  doc/misc/ChangeLog
  doc/misc/tramp.texi

=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog        2013-02-13 08:50:44 +0000
+++ b/doc/misc/ChangeLog        2013-02-16 17:38:37 +0000
@@ -1,3 +1,13 @@
+2013-02-16  Michael Albinus  <address@hidden>
+
+       * tramp.texi (Top, Configuration): Insert section `Android shell
+       setup' in menu.
+       (Android shell setup): New section.
+       (Connection types, Default Method)
+       (Frequently Asked Questions): Mention "scp" instead of "scpc".
+       (External methods): Remove "scpc" and "rsyncc" entries.
+       (Frequently Asked Questions): Remove entry about ControlPersist.
+
 2013-02-13  Glenn Morris  <address@hidden>
 
        * message.texi (News Headers): Don't mention yow any more.

=== modified file 'doc/misc/tramp.texi'
--- a/doc/misc/tramp.texi       2013-01-24 09:43:32 +0000
+++ b/doc/misc/tramp.texi       2013-02-16 17:38:37 +0000
@@ -188,8 +188,9 @@
 * Connection caching::          Reusing connection related information.
 * Remote Programs::             How @value{tramp} finds and uses programs on 
the remote machine.
 * Remote shell setup::          Remote shell setup hints.
+* Android shell setup::         Android shell setup hints.
+* Auto-save and Backup::        Auto-save and Backup.
 * Windows setup hints::         Issues with Cygwin ssh.
-* Auto-save and Backup::        Auto-save and Backup.
 
 Using @value{tramp}
 
@@ -515,6 +516,7 @@
 * Connection caching::          Reusing connection related information.
 * Remote Programs::             How @value{tramp} finds and uses programs on 
the remote machine.
 * Remote shell setup::          Remote shell setup hints.
+* Android shell setup::         Android shell setup hints.
 * Auto-save and Backup::        Auto-save and Backup.
 * Windows setup hints::         Issues with Cygwin ssh.
 @end menu
@@ -557,9 +559,10 @@
 External methods should be configured such a way that they don't
 require a password (with @command{ssh-agent}, or such alike).  Modern
 @command{scp} implementations offer options to reuse existing
address@hidden connections, see method @command{scpc}.  If it isn't
-possible, you should consider @ref{Password handling}, otherwise you
-will be prompted for a password every copy action.
address@hidden connections, which will be enabled by default if
+available.  If it isn't possible, you should consider @ref{Password
+handling}, otherwise you will be prompted for a password every copy
+action.
 
 
 @node Inline methods
@@ -867,51 +870,6 @@
 This method supports the @samp{-p} argument.
 
 
address@hidden @address@hidden and @command{scp}
address@hidden method scpc
address@hidden scpc method
address@hidden scp (with scpc method)
address@hidden ssh (with scpc method)
-
-Newer versions of @option{ssh} (for example OpenSSH 4) offer an option
address@hidden  This allows @option{scp} to reuse an existing
address@hidden channel, which increases performance.
-
-Before you use this method, you should check whether your @option{ssh}
-implementation supports this option.  Try from the command line
-
address@hidden
-ssh localhost -o ControlMaster=yes /bin/true
address@hidden example
-
-If that command succeeds silently, then you can use @option{scpc}; but
-if it fails like
-
address@hidden
-command-line: line 0: Bad configuration option: ControlMaster
address@hidden example
-
-then you cannot use it.  Note, that the option
address@hidden, if it is supported by your @option{ssh}
-version, must be set to @option{no}.
-
-This method supports the @samp{-p} argument.
-
-
address@hidden @address@hidden and @command{rsync}
address@hidden method rsyncc
address@hidden rsyncc method
address@hidden rsync (with rsyncc method)
address@hidden ssh (with rsyncc method)
-
-Like the @option{scpc} method, @option{rsyncc} improves the underlying
address@hidden connection by the option @option{ControlMaster}.  This
-allows @command{rsync} to reuse an existing @command{ssh} channel,
-which increases performance.
-
-This method supports the @samp{-p} argument.
-
-
 @item @address@hidden and @command{pscp}
 @cindex method pscp
 @cindex pscp method
@@ -1240,7 +1198,7 @@
 shortened syntax for the @samp{root} account, like
 @address@hidden, , , /etc/motd}}.
 
-People who edit large files may want to consider @option{scpc} instead
+People who edit large files may want to consider @option{scp} instead
 of @option{ssh}, or @option{pscp} instead of @option{plink}.  These
 external methods are faster than inline methods for large files.
 Note, however, that external methods suffer from some limitations.
@@ -1343,7 +1301,7 @@
 hosts for certain method/user combinations via the variable
 @code{tramp-default-host-alist}.  Usually, this isn't necessary,
 because @code{tramp-default-host} should be sufficient.  For some
-methods, like @code{adb}, that default value must be overwritten,
+methods, like @option{adb}, that default value must be overwritten,
 which is already the initial value of @code{tramp-default-host-alist}.
 
 @noindent
@@ -2047,6 +2005,50 @@
 @end table
 
 
address@hidden Android shell setup
address@hidden Android shell setup hints
address@hidden android shell setup
+
+Android devices use a restricted shell.  They can be accessed via the
address@hidden method.  However, this restricts the access to a USB
+connection, and it requires the installation of the Android SDK on the
+local machine.
+
+When an @command{sshd} process runs on the Android device, like
+provided by the @code{SSHDroid} app, any @option{ssh}-based method can
+be used.  However, this requires some special settings.
+
+The default shell @code{/bin/sh} does not exist.  Instead, you shall
+use just @code{sh}, which invokes the shell installed on the device.
+You can instruct @value{tramp} by this form:
+
address@hidden
+(add-to-list 'tramp-connection-properties
+            (list (regexp-quote "192.168.0.26") "remote-shell" "sh"))
address@hidden lisp
+
address@hidden
+with @samp{192.168.0.26} being the IP address of your Android device.
+
+The user settings for the @code{$PATH} environment valiable must be
+preserved. Add this setting:
+
address@hidden
+(add-to-list 'tramp-remote-path 'tramp-own-remote-path)
address@hidden lisp
+
+If the Android device is not @samp{rooted}, you must give the shell a
+writable directory for temporary files.  You could use this setting:
+
address@hidden
+(add-to-list 'tramp-remote-process-environment "TMPDIR=$HOME")
address@hidden lisp
+
+Now you shall be able to open a remote connection with @kbd{C-x C-f
address@hidden, , 192.168.0.26#2222, }}, given that @command{sshd}
+listens on port @samp{2222}.
+
+
 @node Auto-save and Backup
 @section Auto-save and Backup configuration
 @cindex auto-save
@@ -2942,7 +2944,7 @@
 In order to speed up @value{tramp}, one could either try to avoid some
 of the operations, or one could try to improve their performance.
 
-Use an external method, like @option{scpc}.
+Use an external method, like @option{scp}.
 
 Use caching.  This is already enabled by default.  Information about
 the remote host as well as the remote files are cached for reuse.  The
@@ -3068,20 +3070,6 @@
 
 
 @item
-How can I use @samp{ControlPersist}?
-
-When @samp{ControlPersist} is set to @samp{yes}, the @option{scpc}
-method does not work.  You can use @option{scpx} instead with the
-following settings in @file{~/.ssh/config}:
-
address@hidden
-Host *
-     ControlMaster  auto
-     ControlPersist yes
address@hidden example
-
-
address@hidden
 File name completion does not work with @value{tramp}
 
 When you log in to the remote machine, do you see the output of