comparison man/tramp.texi @ 46010:d07b0e5f80b9

(tramp-open-connection-rsh): Support a kludgy feature for the "-p" option to ssh. If host name is given as "host#42", uses the "-p 42" option.
author Kai Großjohann <kgrossjo@eu.uu.net>
date Tue, 25 Jun 2002 20:11:34 +0000
parents 87962bf716e3
children 49f06e689a20
comparison
equal deleted inserted replaced
46009:72200622ada8 46010:d07b0e5f80b9
9 @footnotestyle end 9 @footnotestyle end
10 10
11 @c Version values, for easy modification 11 @c Version values, for easy modification
12 @c NOTE: The 'UPDATED' value is updated by the 'time-stamp' function. 12 @c NOTE: The 'UPDATED' value is updated by the 'time-stamp' function.
13 @c If you change it by hand, the modifications will not stay. 13 @c If you change it by hand, the modifications will not stay.
14 @set VERSION $Revision: 1.2 $ 14 @set VERSION $Revision: 1.3 $
15 @set UPDATED Monday, 17 June, 2002 15 @set UPDATED Monday, 17 June, 2002
16 16
17 17
18 @c Entries for @command{install-info} to use 18 @c Entries for @command{install-info} to use
19 @direntry 19 @direntry
637 637
638 There are also two variants, @option{sm1} and @option{sm2} that use the 638 There are also two variants, @option{sm1} and @option{sm2} that use the
639 @command{ssh1} and @command{ssh2} commands explicitly. If you don't know 639 @command{ssh1} and @command{ssh2} commands explicitly. If you don't know
640 what these are, you do not need these options. 640 what these are, you do not need these options.
641 641
642 All the methods based on @command{ssh} have an additional kludgy
643 feature: you can specify a host name which looks like @file{host#42}
644 (the real host name, then a hash sign, then a port number). This
645 means to connect to the given host but to also pass @code{-p 42} as
646 arguments to the @command{ssh} command.
647
642 648
643 @item @option{tm} --- @command{telnet} with @command{mimencode} 649 @item @option{tm} --- @command{telnet} with @command{mimencode}
644 650
645 Connect to the remote host with @command{telnet} and use base64 encoding 651 Connect to the remote host with @command{telnet} and use base64 encoding
646 to transfer files between the machines. 652 to transfer files between the machines.
660 666
661 Connect to the remote host with @command{ssh} and use the 667 Connect to the remote host with @command{ssh} and use the
662 @command{uuencode} and @command{uudecode} commands to transfer files 668 @command{uuencode} and @command{uudecode} commands to transfer files
663 between the machines. 669 between the machines.
664 670
665 As with the @command{ssh} and base64 option above, this provides the 671 As with the @command{ssh} and base64 option (@option{sm}) above, this
666 @option{su1} and @option{su2} methods to explicitly select an ssh 672 provides the @option{su1} and @option{su2} methods to explicitly
667 version. 673 select an ssh version.
668 674
669 Note that this method does not invoke the @command{su} program, see 675 Note that this method does not invoke the @command{su} program, see
670 below for methods which use that. 676 below for methods which use that.
677
678 This supports the @command{-p} kludge.
671 679
672 680
673 @item @option{tu} --- @command{telnet} with @command{uuencode} 681 @item @option{tu} --- @command{telnet} with @command{uuencode}
674 682
675 Connect to the remote host with @command{telnet} and use the 683 Connect to the remote host with @command{telnet} and use the
721 This is also useful for Windows users where @command{ssh}, when 729 This is also useful for Windows users where @command{ssh}, when
722 invoked from an Emacs buffer, tells them that it is not allocating a 730 invoked from an Emacs buffer, tells them that it is not allocating a
723 pseudo tty. When this happens, the login shell is wont to not print 731 pseudo tty. When this happens, the login shell is wont to not print
724 any shell prompt, which confuses @tramp{} mightily. 732 any shell prompt, which confuses @tramp{} mightily.
725 733
734 This supports the @command{-p} kludge.
735
726 736
727 @item @option{km} --- @command{krlogin} with @command{mimencode} 737 @item @option{km} --- @command{krlogin} with @command{mimencode}
728 738
729 This method is also similar to @option{sm}. It only uses the 739 This method is also similar to @option{sm}. It only uses the
730 @command{krlogin -x} command to log in to the remote host. 740 @command{krlogin -x} command to log in to the remote host.
736 implementation of SSH. It uses @command{plink -ssh} to log in to the 746 implementation of SSH. It uses @command{plink -ssh} to log in to the
737 remote host. 747 remote host.
738 748
739 CCC: Do we have to connect to the remote host once from the command 749 CCC: Do we have to connect to the remote host once from the command
740 line to accept the SSH key? Maybe this can be made automatic? 750 line to accept the SSH key? Maybe this can be made automatic?
751
752 CCC: Does @command{plink} support the @command{-p} option? Tramp
753 will support that, anyway.
741 754
742 @item @option{plinkm} --- @command{plink} with @command{mimencode} 755 @item @option{plinkm} --- @command{plink} with @command{mimencode}
743 756
744 Like @option{plinku}, but uses base64 encoding instead of uu encoding. 757 Like @option{plinku}, but uses base64 encoding instead of uu encoding.
745 758
791 the inline methods when you often open and close small files however. 804 the inline methods when you often open and close small files however.
792 The cost of the cryptographic handshake at the start of an @command{scp} 805 The cost of the cryptographic handshake at the start of an @command{scp}
793 session can begin to absorb the advantage that the lack of encoding and 806 session can begin to absorb the advantage that the lack of encoding and
794 decoding presents. 807 decoding presents.
795 808
809 All the @command{ssh} based methods support the kludgy @command{-p}
810 feature where you can specify a port number to connect to in the host
811 name. For example, the host name @file{host#42} tells Tramp to
812 specify @command{-p 42} in the argument list for @command{ssh}.
813
796 814
797 @item @option{rsync} --- @command{ssh} and @command{rsync} 815 @item @option{rsync} --- @command{ssh} and @command{rsync}
798 816
799 Using the @command{ssh} command to connect securely to the remote 817 Using the @command{ssh} command to connect securely to the remote
800 machine and the @command{rsync} command to transfer files is almost 818 machine and the @command{rsync} command to transfer files is almost
805 the file exists only on one side of the connection. 823 the file exists only on one side of the connection.
806 824
807 The @command{rsync} based method may be considerably faster than the 825 The @command{rsync} based method may be considerably faster than the
808 @command{rcp} based methods when writing to the remote system. Reading 826 @command{rcp} based methods when writing to the remote system. Reading
809 files to the local machine is no faster than with a direct copy. 827 files to the local machine is no faster than with a direct copy.
828
829 This method supports the @command{-p} hack.
810 830
811 831
812 @item @option{scpx} --- @command{ssh} and @command{scp} 832 @item @option{scpx} --- @command{ssh} and @command{scp}
813 833
814 As you expect, this is similar to @option{scp}, only a little 834 As you expect, this is similar to @option{scp}, only a little
822 This is also useful for Windows users where @command{ssh}, when 842 This is also useful for Windows users where @command{ssh}, when
823 invoked from an Emacs buffer, tells them that it is not allocating a 843 invoked from an Emacs buffer, tells them that it is not allocating a
824 pseudo tty. When this happens, the login shell is wont to not print 844 pseudo tty. When this happens, the login shell is wont to not print
825 any shell prompt, which confuses @tramp{} mightily. 845 any shell prompt, which confuses @tramp{} mightily.
826 846
847 This method supports the @command{-p} hack.
848
827 849
828 @item @option{pscp} --- @command{plink} and @command{pscp} 850 @item @option{pscp} --- @command{plink} and @command{pscp}
829 851
830 This method is similar to @option{scp}, but it uses the 852 This method is similar to @option{scp}, but it uses the
831 @command{plink} command to connect to the remote host, and it uses 853 @command{plink} command to connect to the remote host, and it uses
832 @command{pscp} for transferring the files. These programs are part 854 @command{pscp} for transferring the files. These programs are part
833 of PuTTY, an SSH implementation for Windows. 855 of PuTTY, an SSH implementation for Windows.
856
857 CCC: Does @command{plink} support the @command{-p} hack?
834 858
835 859
836 @item @option{fcp} --- @command{fsh} and @command{fcp} 860 @item @option{fcp} --- @command{fsh} and @command{fcp}
837 861
838 This method is similar to @option{scp}, but it uses the @command{fsh} 862 This method is similar to @option{scp}, but it uses the @command{fsh}