diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/misc/ChangeLog | 7 | ||||
| -rw-r--r-- | doc/misc/tramp.texi | 36 |
2 files changed, 19 insertions, 24 deletions
diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog index 48561089dc0..b256bac417f 100644 --- a/doc/misc/ChangeLog +++ b/doc/misc/ChangeLog | |||
| @@ -1,3 +1,10 @@ | |||
| 1 | 2013-03-01 Michael Albinus <michael.albinus@gmx.de> | ||
| 2 | |||
| 3 | * tramp.texi (Inline methods): Remove "ssh1", "ssh2", "plink1" | ||
| 4 | and "plink2" entries. "plink2" is obsolete for a long time. | ||
| 5 | (External methods): Remove "scp1" and "scp2" entries. Explain | ||
| 6 | user name and host name specification for "adb". | ||
| 7 | |||
| 1 | 2013-02-28 Michael Albinus <michael.albinus@gmx.de> | 8 | 2013-02-28 Michael Albinus <michael.albinus@gmx.de> |
| 2 | 9 | ||
| 3 | * tramp.texi (External methods): Mention `tramp-adb-program'. | 10 | * tramp.texi (External methods): Mention `tramp-adb-program'. |
diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi index 1052b030691..84eee0c4319 100644 --- a/doc/misc/tramp.texi +++ b/doc/misc/tramp.texi | |||
| @@ -649,13 +649,6 @@ Connect to the remote host with @command{ssh}. This is identical to | |||
| 649 | the previous option except that the @command{ssh} package is used, | 649 | the previous option except that the @command{ssh} package is used, |
| 650 | making the connection more secure. | 650 | making the connection more secure. |
| 651 | 651 | ||
| 652 | There are also two variants, @option{ssh1} and @option{ssh2}, that | ||
| 653 | call @samp{ssh -1} and @samp{ssh -2}, respectively. This way, you can | ||
| 654 | explicitly select whether you want to use the SSH protocol version 1 | ||
| 655 | or 2 to connect to the remote host. (You can also specify in | ||
| 656 | @file{~/.ssh/config}, the SSH configuration file, which protocol | ||
| 657 | should be used, and use the regular @option{ssh} method.) | ||
| 658 | |||
| 659 | All the methods based on @command{ssh} have an additional feature: you | 652 | All the methods based on @command{ssh} have an additional feature: you |
| 660 | can specify a host name which looks like @file{host#42} (the real host | 653 | can specify a host name which looks like @file{host#42} (the real host |
| 661 | name, then a hash sign, then a port number). This means to connect to | 654 | name, then a hash sign, then a port number). This means to connect to |
| @@ -751,16 +744,6 @@ remote host. | |||
| 751 | 744 | ||
| 752 | This supports the @samp{-P} argument. | 745 | This supports the @samp{-P} argument. |
| 753 | 746 | ||
| 754 | Additionally, the methods @option{plink1} and @option{plink2} are | ||
| 755 | provided, which call @samp{plink -1 -ssh} or @samp{plink -2 -ssh} in | ||
| 756 | order to use SSH protocol version 1 or 2 explicitly. | ||
| 757 | |||
| 758 | CCC: Do we have to connect to the remote host once from the command | ||
| 759 | line to accept the SSH key? Maybe this can be made automatic? | ||
| 760 | |||
| 761 | CCC: Say something about the first shell command failing. This might | ||
| 762 | be due to a wrong setting of @code{tramp-rsh-end-of-line}. | ||
| 763 | |||
| 764 | 747 | ||
| 765 | @item @option{plinkx} | 748 | @item @option{plinkx} |
| 766 | @cindex method plinkx | 749 | @cindex method plinkx |
| @@ -824,13 +807,6 @@ The cost of the cryptographic handshake at the start of an @command{scp} | |||
| 824 | session can begin to absorb the advantage that the lack of encoding and | 807 | session can begin to absorb the advantage that the lack of encoding and |
| 825 | decoding presents. | 808 | decoding presents. |
| 826 | 809 | ||
| 827 | There are also two variants, @option{scp1} and @option{scp2}, that | ||
| 828 | call @samp{ssh -1} and @samp{ssh -2}, respectively. This way, you can | ||
| 829 | explicitly select whether you want to use the SSH protocol version 1 | ||
| 830 | or 2 to connect to the remote host. (You can also specify in | ||
| 831 | @file{~/.ssh/config}, the SSH configuration file, which protocol | ||
| 832 | should be used, and use the regular @option{scp} method.) | ||
| 833 | |||
| 834 | All the @command{ssh} based methods support the @samp{-p} feature | 810 | All the @command{ssh} based methods support the @samp{-p} feature |
| 835 | where you can specify a port number to connect to in the host name. | 811 | where you can specify a port number to connect to in the host name. |
| 836 | For example, the host name @file{host#42} tells @value{tramp} to | 812 | For example, the host name @file{host#42} tells @value{tramp} to |
| @@ -1029,6 +1005,18 @@ can be installed as part of the Android SDK. If @command{adb} is not | |||
| 1029 | found via the @code{$PATH} environment variable, the variable | 1005 | found via the @code{$PATH} environment variable, the variable |
| 1030 | @var{tramp-adb-program} must point to its absolute path. | 1006 | @var{tramp-adb-program} must point to its absolute path. |
| 1031 | 1007 | ||
| 1008 | Usually, the @command{adb} method does not need any user name. It | ||
| 1009 | runs under the permissions of the @command{adbd} process on the | ||
| 1010 | Android device. If a user name is specified, @value{tramp} applies an | ||
| 1011 | @command{su} on the device. This does not work with all Android | ||
| 1012 | devices, especially with nonrooted ones. In that case, an error | ||
| 1013 | message is displayed. | ||
| 1014 | |||
| 1015 | If there is exactly one Android device connected to the local machine, | ||
| 1016 | a host name is not needed. The shortest @value{tramp} name to be used | ||
| 1017 | is @file{@trampfn{adb, , ,}} therefore. Otherwise, one could find | ||
| 1018 | potential host names with the shell command @command{adb devices}. | ||
| 1019 | |||
| 1032 | @end table | 1020 | @end table |
| 1033 | 1021 | ||
| 1034 | 1022 | ||