Function: tramp-smb-handle-copy-file

tramp-smb-handle-copy-file is a byte-compiled function defined in tramp-smb.el.gz.

Signature

(tramp-smb-handle-copy-file FILENAME NEWNAME &optional OK-IF-ALREADY-EXISTS KEEP-DATE PRESERVE-UID-GID PRESERVE-EXTENDED-ATTRIBUTES)

Documentation

Like copy-file for Tramp files.

KEEP-DATE has no effect in case NEWNAME resides on an SMB server. PRESERVE-UID-GID and PRESERVE-EXTENDED-ATTRIBUTES are completely ignored.

Source Code

;; Defined in /usr/src/emacs/lisp/net/tramp-smb.el.gz
(defun tramp-smb-handle-copy-file
  (filename newname &optional ok-if-already-exists keep-date
   _preserve-uid-gid _preserve-extended-attributes)
  "Like `copy-file' for Tramp files.
KEEP-DATE has no effect in case NEWNAME resides on an SMB server.
PRESERVE-UID-GID and PRESERVE-EXTENDED-ATTRIBUTES are completely ignored."
  (setq filename (expand-file-name filename)
	newname (expand-file-name newname))

  (with-parsed-tramp-file-name
      (if (tramp-tramp-file-p filename) filename newname) nil
    (with-tramp-progress-reporter
	v 0 (format "Copying %s to %s" filename newname)

      (if (file-directory-p filename)
	  (copy-directory filename newname keep-date 'parents 'copy-contents)

	(tramp-barf-if-file-missing v filename
	  ;; `file-local-copy' returns a file name also for a local
	  ;; file with `jka-compr-handler', so we cannot trust its
	  ;; result as indication for a remote file name.
	  (if-let* ((tmpfile
		     (and (tramp-tramp-file-p filename)
			  (file-local-copy filename))))
	      ;; Remote filename.
	      (condition-case err
		  (rename-file tmpfile newname ok-if-already-exists)
		((error quit)
		 (delete-file tmpfile)
		 (signal (car err) (cdr err))))

	    ;; Remote newname.
	    (when (and (file-directory-p newname)
		       (directory-name-p newname))
	      (setq newname
		    (expand-file-name
		     (file-name-nondirectory filename) newname)))

	    (when (and (not ok-if-already-exists) (file-exists-p newname))
	      (tramp-error v 'file-already-exists newname))
	    (when (and (file-directory-p newname)
		       (not (directory-name-p newname)))
	      (tramp-error v 'file-error "File is a directory %s" newname))

	    (unless (tramp-smb-get-share v)
	      (tramp-error
	       v 'file-error "Target `%s' must contain a share name" newname))
	    (unless (tramp-smb-send-command
		     v (format "put %s %s"
			       (tramp-smb-shell-quote-argument filename)
			       (tramp-smb-shell-quote-localname v)))
	      (tramp-error
	       v 'file-error "Cannot copy `%s' to `%s'" filename newname))

	    ;; When newname did exist, we have wrong cached values.
	    (when (tramp-tramp-file-p newname)
	      (with-parsed-tramp-file-name newname v2
		(tramp-flush-file-properties v2 v2-localname))))))

      ;; KEEP-DATE handling.
      (when keep-date
	(set-file-times
	 newname
	 (file-attribute-modification-time (file-attributes filename))
	 (unless ok-if-already-exists 'nofollow))))))