--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/lisp/comint/ssh.el	Mon Aug 13 09:38:25 2007 +0200
@@ -0,0 +1,358 @@
+;;; ssh.el --- remote login interface
+
+;; Copyright (C) 1996, 1997 Noah S. Friedman
+
+;; Author: Noah Friedman <friedman@prep.ai.mit.edu>
+;; Maintainer: friedman@prep.ai.mit.edu
+;; Keywords: unix, comm
+;; Created: 1996-07-03
+
+;; $Id: ssh.el,v 1.1 1997/05/28 16:30:50 steve Exp $
+
+;; This program is free software; you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation; either version 2, or (at your option)
+;; any later version.
+;;
+;; This program is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+;; GNU General Public License for more details.
+;;
+;; You should have received a copy of the GNU General Public License
+;; along with this program; if not, you can either send email to this
+;; program's maintainer or write to: The Free Software Foundation,
+;; Inc.; 59 Temple Place, Suite 330; Boston, MA 02111-1307, USA.
+
+;;; Commentary:
+
+;; Support for remote logins using `ssh'.
+;; This program is layered on top of shell.el; the code here only accounts
+;; for the variations needed to handle a remote process, e.g. directory
+;; tracking and the sending of some special characters.
+
+;; If you wish for ssh mode to prompt you in the minibuffer for
+;; passwords when a password prompt appears, just enter m-x send-invisible
+;; and type in your line, or add `comint-watch-for-password-prompt' to
+;; `comint-output-filter-functions'.
+
+;;; Code:
+
+(require 'comint)
+(require 'shell)
+
+(defgroup ssh nil
+  "Secure remote login interface"
+  :group 'processes
+  :group 'unix)
+
+(defcustom ssh-program "ssh"
+  "*Name of program to invoke ssh"
+  :type 'string
+  :group 'ssh)
+
+(defcustom ssh-explicit-args '()
+  "*List of arguments to pass to ssh on the command line."
+  :type '(repeat (string :tag "Argument"))
+  :group 'ssh)
+
+(defcustom ssh-mode-hook nil
+  "*Hooks to run after setting current buffer to ssh-mode."
+  :type 'hook
+  :group 'ssh)
+
+(defcustom ssh-process-connection-type t
+  "*If non-`nil', use a pty for the local ssh process.
+If `nil', use a pipe (if pipes are supported on the local system).
+
+Generally it is better not to waste ptys on systems which have a static
+number of them.  However, ssh won't allocate a pty on the remote host
+unless one is used locally as well."
+  :type '(choice (const :tag "ptys" t)
+		 (const :tag "pipes" nil))
+  :group 'ssh)
+
+(defcustom ssh-directory-tracking-mode 'local
+  "*Control whether and how to do directory tracking in an ssh buffer.
+
+nil means don't do directory tracking.
+
+t means do so using an ftp remote file name.
+
+Any other value means do directory tracking using local file names.
+This works only if the remote machine and the local one
+share the same directories (through NFS).  This is the default.
+
+This variable becomes local to a buffer when set in any fashion for it.
+
+It is better to use the function of the same name to change the behavior of
+directory tracking in an ssh session once it has begun, rather than
+simply setting this variable, since the function does the necessary
+re-synching of directories."
+  :type '(choice (const :tag "off" nil)
+		 (const :tag "ftp" t)
+		 (const :tag "local" local))
+  :group 'ssh)
+
+(make-variable-buffer-local 'ssh-directory-tracking-mode)
+
+(defcustom ssh-host nil
+  "*The name of the remote host.  This variable is buffer-local."
+  :type '(choice (const nil) string)
+  :group 'ssh)
+
+(defcustom ssh-remote-user nil
+  "*The username used on the remote host.
+This variable is buffer-local and defaults to your local user name.
+If ssh is invoked with the `-l' option to specify the remote username,
+this variable is set from that."
+  :type '(choice (const nil) string)
+  :group 'ssh)
+
+;; Initialize ssh mode map.
+(defvar ssh-mode-map '())
+(cond
+ ((null ssh-mode-map)
+  (setq ssh-mode-map (if (consp shell-mode-map)
+                            (cons 'keymap shell-mode-map)
+                          (copy-keymap shell-mode-map)))
+  (define-key ssh-mode-map "\C-c\C-c" 'ssh-send-Ctrl-C)
+  (define-key ssh-mode-map "\C-c\C-d" 'ssh-send-Ctrl-D)
+  (define-key ssh-mode-map "\C-c\C-z" 'ssh-send-Ctrl-Z)
+  (define-key ssh-mode-map "\C-c\C-\\" 'ssh-send-Ctrl-backslash)
+  (define-key ssh-mode-map "\C-d" 'ssh-delchar-or-send-Ctrl-D)
+  (define-key ssh-mode-map "\C-i" 'ssh-tab-or-complete)))
+
+
+;;;###autoload (add-hook 'same-window-regexps "^\\*ssh-.*\\*\\(\\|<[0-9]+>\\)")
+
+(defvar ssh-history nil)
+
+;;;###autoload
+(defun ssh (input-args &optional buffer)
+  "Open a network login connection via `ssh' with args INPUT-ARGS.
+INPUT-ARGS should start with a host name; it may also contain
+other arguments for `ssh'.
+
+Input is sent line-at-a-time to the remote connection.
+
+Communication with the remote host is recorded in a buffer `*ssh-HOST*'
+\(or `*ssh-USER@HOST*' if the remote username differs\).
+If a prefix argument is given and the buffer `*ssh-HOST*' already exists,
+a new buffer with a different connection will be made.
+
+When called from a program, if the optional second argument BUFFER is
+a string or buffer, it specifies the buffer to use.
+
+The variable `ssh-program' contains the name of the actual program to
+run.  It can be a relative or absolute path.
+
+The variable `ssh-explicit-args' is a list of arguments to give to
+the ssh when starting.  They are prepended to any arguments given in
+INPUT-ARGS.
+
+If the default value of `ssh-directory-tracking-mode' is t, then the
+default directory in that buffer is set to a remote (FTP) file name to
+access your home directory on the remote machine.  Occasionally this causes
+an error, if you cannot access the home directory on that machine.  This
+error is harmless as long as you don't try to use that default directory.
+
+If `ssh-directory-tracking-mode' is neither t nor nil, then the default
+directory is initially set up to your (local) home directory.
+This is useful if the remote machine and your local machine
+share the same files via NFS.  This is the default.
+
+If you wish to change directory tracking styles during a session, use the
+function `ssh-directory-tracking-mode' rather than simply setting the
+variable."
+  (interactive (list
+		(read-from-minibuffer "ssh arguments (hostname first): "
+				      nil nil nil 'ssh-history)
+		current-prefix-arg))
+
+  (let* ((process-connection-type ssh-process-connection-type)
+         (args (ssh-parse-words input-args))
+	 (host (car args))
+	 (user (or (car (cdr (member "-l" args)))
+                   (user-login-name)))
+         (buffer-name (if (string= user (user-login-name))
+                          (format "*ssh-%s*" host)
+                        (format "*ssh-%s@%s*" user host)))
+	 proc)
+
+    (and ssh-explicit-args
+         (setq args (append ssh-explicit-args args)))
+
+    (cond ((null buffer))
+	  ((stringp buffer)
+	   (setq buffer-name buffer))
+          ((bufferp buffer)
+           (setq buffer-name (buffer-name buffer)))
+          ((numberp buffer)
+           (setq buffer-name (format "%s<%d>" buffer-name buffer)))
+          (t
+           (setq buffer-name (generate-new-buffer-name buffer-name))))
+
+    (setq buffer (get-buffer-create buffer-name))
+    (pop-to-buffer buffer-name)
+
+    (cond
+     ((comint-check-proc buffer-name))
+     (t
+      (comint-exec buffer buffer-name ssh-program nil args)
+      (setq proc (get-buffer-process buffer))
+      ;; Set process-mark to point-max in case there is text in the
+      ;; buffer from a previous exited process.
+      (set-marker (process-mark proc) (point-max))
+
+      ;; comint-output-filter-functions is just like a hook, except that the
+      ;; functions in that list are passed arguments.  add-hook serves well
+      ;; enough for modifying it.
+      ;; comint-output-filter-functions should already have a
+      ;; permanent-local property, at least in emacs 19.27 or later.
+      (if (fboundp 'make-local-hook)
+          (make-local-hook 'comint-output-filter-functions)
+        (make-local-variable 'comint-output-filter-functions))
+      (add-hook 'comint-output-filter-functions 'ssh-carriage-filter)
+
+      (ssh-mode)
+
+      (make-local-variable 'ssh-host)
+      (setq ssh-host host)
+      (make-local-variable 'ssh-remote-user)
+      (setq ssh-remote-user user)
+
+      (condition-case ()
+          (cond ((eq ssh-directory-tracking-mode t)
+                 ;; Do this here, rather than calling the tracking mode
+                 ;; function, to avoid a gratuitous resync check; the default
+                 ;; should be the user's home directory, be it local or remote.
+                 (setq comint-file-name-prefix
+                       (concat "/" ssh-remote-user "@" ssh-host ":"))
+                 (cd-absolute comint-file-name-prefix))
+                ((null ssh-directory-tracking-mode))
+                (t
+                 (cd-absolute (concat comint-file-name-prefix "~/"))))
+        (error nil))))))
+
+(put 'ssh-mode 'mode-class 'special)
+
+(defun ssh-mode ()
+  "Set major-mode for ssh sessions.
+If `ssh-mode-hook' is set, run it."
+  (interactive)
+  (kill-all-local-variables)
+  (shell-mode)
+  (setq major-mode 'ssh-mode)
+  (setq mode-name "ssh")
+  (use-local-map ssh-mode-map)
+  (setq shell-dirtrackp ssh-directory-tracking-mode)
+  (make-local-variable 'comint-file-name-prefix)
+  (run-hooks 'ssh-mode-hook))
+
+(defun ssh-directory-tracking-mode (&optional prefix)
+  "Do remote or local directory tracking, or disable entirely.
+
+If called with no prefix argument or a unspecified prefix argument (just
+``\\[universal-argument]'' with no number) do remote directory tracking via
+ange-ftp.  If called as a function, give it no argument.
+
+If called with a negative prefix argument, disable directory tracking
+entirely.
+
+If called with a positive, numeric prefix argument, e.g.
+``\\[universal-argument] 1 M-x ssh-directory-tracking-mode\'',
+then do directory tracking but assume the remote filesystem is the same as
+the local system.  This only works in general if the remote machine and the
+local one share the same directories (through NFS)."
+  (interactive "P")
+  (cond
+   ((or (null prefix)
+        (consp prefix))
+    (setq ssh-directory-tracking-mode t)
+    (setq shell-dirtrackp t)
+    (setq comint-file-name-prefix
+          (concat "/" ssh-remote-user "@" ssh-host ":")))
+   ((< prefix 0)
+    (setq ssh-directory-tracking-mode nil)
+    (setq shell-dirtrackp nil))
+   (t
+    (setq ssh-directory-tracking-mode 'local)
+    (setq comint-file-name-prefix "")
+    (setq shell-dirtrackp t)))
+  (cond
+   (shell-dirtrackp
+    (let* ((proc (get-buffer-process (current-buffer)))
+           (proc-mark (process-mark proc))
+           (current-input (buffer-substring proc-mark (point-max)))
+           (orig-point (point))
+           (offset (and (>= orig-point proc-mark)
+                        (- (point-max) orig-point))))
+      (unwind-protect
+          (progn
+            (delete-region proc-mark (point-max))
+            (goto-char (point-max))
+            (shell-resync-dirs))
+        (goto-char proc-mark)
+        (insert current-input)
+        (if offset
+            (goto-char (- (point-max) offset))
+          (goto-char orig-point)))))))
+
+
+;; Parse a line into its constituent parts (words separated by
+;; whitespace).  Return a list of the words.
+(defun ssh-parse-words (line)
+  (let ((list nil)
+	(posn 0)
+        (match-data (match-data)))
+    (while (string-match "[^ \t\n]+" line posn)
+      (setq list (cons (substring line (match-beginning 0) (match-end 0))
+                       list))
+      (setq posn (match-end 0)))
+    (store-match-data (match-data))
+    (nreverse list)))
+
+(defun ssh-carriage-filter (string)
+  (let* ((point-marker (point-marker))
+         (end (process-mark (get-buffer-process (current-buffer))))
+         (beg (or (and (boundp 'comint-last-output-start)
+                       comint-last-output-start)
+                  (- end (length string)))))
+    (goto-char beg)
+    (while (search-forward "\C-m" end t)
+      (delete-char -1))
+    (goto-char point-marker)))
+
+(defun ssh-send-Ctrl-C ()
+  (interactive)
+  (send-string nil "\C-c"))
+
+(defun ssh-send-Ctrl-D ()
+  (interactive)
+  (send-string nil "\C-d"))
+
+(defun ssh-send-Ctrl-Z ()
+  (interactive)
+  (send-string nil "\C-z"))
+
+(defun ssh-send-Ctrl-backslash ()
+  (interactive)
+  (send-string nil "\C-\\"))
+
+(defun ssh-delchar-or-send-Ctrl-D (arg)
+  "\
+Delete ARG characters forward, or send a C-d to process if at end of buffer."
+  (interactive "p")
+  (if (eobp)
+      (ssh-send-Ctrl-D)
+    (delete-char arg)))
+
+(defun ssh-tab-or-complete ()
+  "Complete file name if doing directory tracking, or just insert TAB."
+  (interactive)
+  (if ssh-directory-tracking-mode
+      (comint-dynamic-complete)
+    (insert "\C-i")))
+
+;;; ssh.el ends here