1 ;;; tar-mode.el --- simple editing of tar files from GNU emacs
3 ;; Copyright (C) 1990, 1991, 1993, 1994, 1995 Free Software Foundation, Inc.
5 ;; Author: Jamie Zawinski <jwz@lucid.com>
7 ;; Created: 04 Apr 1990
10 ;; This file is part of GNU Emacs.
12 ;; GNU Emacs is free software; you can redistribute it and/or modify
13 ;; it under the terms of the GNU General Public License as published by
14 ;; the Free Software Foundation; either version 2, or (at your option)
17 ;; GNU Emacs is distributed in the hope that it will be useful,
18 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 ;; GNU General Public License for more details.
22 ;; You should have received a copy of the GNU General Public License
23 ;; along with GNU Emacs; see the file COPYING. If not, write to the
24 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
25 ;; Boston, MA 02111-1307, USA.
29 ;; This package attempts to make dealing with Unix 'tar' archives easier.
30 ;; When this code is loaded, visiting a file whose name ends in '.tar' will
31 ;; cause the contents of that archive file to be displayed in a Dired-like
32 ;; listing. It is then possible to use the customary Dired keybindings to
33 ;; extract sub-files from that archive, either by reading them into their own
34 ;; editor buffers, or by copying them directly to arbitrary files on disk.
35 ;; It is also possible to delete sub-files from within the tar file and write
36 ;; the modified archive back to disk, or to edit sub-files within the archive
37 ;; and re-insert the modified files into the archive. See the documentation
38 ;; string of tar-mode for more info.
40 ;; This code now understands the extra fields that GNU tar adds to tar files.
42 ;; This interacts correctly with "uncompress.el" in the Emacs library,
45 ;; (autoload 'uncompress-while-visiting "uncompress")
46 ;; (setq auto-mode-alist (cons '("\\.Z$" . uncompress-while-visiting)
49 ;; Do not attempt to use tar-mode.el with crypt.el, you will lose.
51 ;; *************** TO DO ***************
53 ;; o chmod should understand "a+x,og-w".
55 ;; o It's not possible to add a NEW file to a tar archive; not that
56 ;; important, but still...
58 ;; o The code is less efficient that it could be - in a lot of places, I
59 ;; pull a 512-character string out of the buffer and parse it, when I could
60 ;; be parsing it in place, not garbaging a string. Should redo that.
62 ;; o I'd like a command that searches for a string/regexp in every subfile
63 ;; of an archive, where <esc> would leave you in a subfile-edit buffer.
64 ;; (Like the Meta-R command of the Zmacs mail reader.)
66 ;; o Sometimes (but not always) reverting the tar-file buffer does not
67 ;; re-grind the listing, and you are staring at the binary tar data.
68 ;; Typing 'g' again immediately after that will always revert and re-grind
69 ;; it, though. I have no idea why this happens.
71 ;; o Tar-mode interacts poorly with crypt.el and zcat.el because the tar
72 ;; write-file-hook actually writes the file. Instead it should remove the
73 ;; header (and conspire to put it back afterwards) so that other write-file
74 ;; hooks which frob the buffer have a chance to do their dirty work. There
75 ;; might be a problem if the tar write-file-hook does not come *first* on
78 ;; o Block files, sparse files, continuation files, and the various header
79 ;; types aren't editable. Actually I don't know that they work at all.
83 ;; Why does tar-mode edit the file itself instead of using tar?
85 ;; That means that you can edit tar files which you don't have room for
86 ;; on your local disk.
88 ;; I don't know about recent features in gnu tar, but old versions of tar
89 ;; can't replace a file in the middle of a tar file with a new version.
90 ;; Tar-mode can. I don't think tar can do things like chmod the subfiles.
91 ;; An implementation which involved unpacking and repacking the file into
92 ;; some scratch directory would be very wasteful, and wouldn't be able to
93 ;; preserve the file owners.
98 "Simple editing of tar files."
102 (defcustom tar-anal-blocksize
20
103 "*The blocksize of tar files written by Emacs, or nil, meaning don't care.
104 The blocksize of a tar file is not really the size of the blocks; rather, it is
105 the number of blocks written with one system call. When tarring to a tape,
106 this is the size of the *tape* blocks, but when writing to a file, it doesn't
107 matter much. The only noticeable difference is that if a tar file does not
108 have a blocksize of 20, tar will tell you that; all this really controls is
109 how many null padding bytes go on the end of the tar file."
110 :type
'(choice integer
(const nil
))
113 (defcustom tar-update-datestamp nil
114 "*Non-nil means Tar mode should play fast and loose with sub-file datestamps.
115 If this is true, then editing and saving a tar file entry back into its
116 tar file will update its datestamp. If false, the datestamp is unchanged.
117 You may or may not want this - it is good in that you can tell when a file
118 in a tar archive has been changed, but it is bad for the same reason that
119 editing a file in the tar archive at all is bad - the changed version of
120 the file never exists on disk."
124 (defcustom tar-mode-show-date nil
125 "*Non-nil means Tar mode should show the date/time of each subfile.
126 This information is useful, but it takes screen space away from file names."
130 (defvar tar-parse-info nil
)
131 ;; Be sure that this variable holds byte position, not char position.
132 (defvar tar-header-offset nil
)
133 (defvar tar-superior-buffer nil
)
134 (defvar tar-superior-descriptor nil
)
135 (defvar tar-subfile-mode nil
)
137 (put 'tar-parse-info
'permanent-local t
)
138 (put 'tar-header-offset
'permanent-local t
)
139 (put 'tar-superior-buffer
'permanent-local t
)
140 (put 'tar-superior-descriptor
'permanent-local t
)
142 ;;; First, duplicate some Common Lisp functions; I used to just (require 'cl)
143 ;;; but "cl.el" was messing some people up (also it's really big).
145 (defmacro tar-setf
(form val
)
146 "A mind-numbingly simple implementation of setf."
147 (let ((mform (macroexpand form
(and (boundp 'byte-compile-macro-environment
)
148 byte-compile-macro-environment
))))
149 (cond ((symbolp mform
) (list 'setq mform val
))
150 ((not (consp mform
)) (error "can't setf %s" form
))
151 ((eq (car mform
) 'aref
)
152 (list 'aset
(nth 1 mform
) (nth 2 mform
) val
))
153 ((eq (car mform
) 'car
)
154 (list 'setcar
(nth 1 mform
) val
))
155 ((eq (car mform
) 'cdr
)
156 (list 'setcdr
(nth 1 mform
) val
))
157 (t (error "don't know how to setf %s" form
)))))
159 (defmacro tar-dolist
(control &rest body
)
160 "syntax: (dolist (var-name list-expr &optional return-value) &body body)"
161 (let ((var (car control
))
162 (init (car (cdr control
)))
163 (val (car (cdr (cdr control
)))))
164 (list 'let
(list (list '_dolist_iterator_ init
))
165 (list 'while
'_dolist_iterator_
167 (cons (list (list var
'(car _dolist_iterator_
)))
169 (list (list 'setq
'_dolist_iterator_
170 (list 'cdr
'_dolist_iterator_
)))))))
173 (defmacro tar-dotimes
(control &rest body
)
174 "syntax: (dolist (var-name count-expr &optional return-value) &body body)"
175 (let ((var (car control
))
176 (n (car (cdr control
)))
177 (val (car (cdr (cdr control
)))))
178 (list 'let
(list (list '_dotimes_end_ n
)
181 (cons (list '< var
'_dotimes_end_
)
183 (list (list 'setq var
(list '1+ var
))))))
187 ;;; down to business.
189 (defmacro make-tar-header
(name mode uid git size date ck lt ln
190 magic uname gname devmaj devmin
)
191 (list 'vector name mode uid git size date ck lt ln
192 magic uname gname devmaj devmin
))
194 (defmacro tar-header-name
(x) (list 'aref x
0))
195 (defmacro tar-header-mode
(x) (list 'aref x
1))
196 (defmacro tar-header-uid
(x) (list 'aref x
2))
197 (defmacro tar-header-gid
(x) (list 'aref x
3))
198 (defmacro tar-header-size
(x) (list 'aref x
4))
199 (defmacro tar-header-date
(x) (list 'aref x
5))
200 (defmacro tar-header-checksum
(x) (list 'aref x
6))
201 (defmacro tar-header-link-type
(x) (list 'aref x
7))
202 (defmacro tar-header-link-name
(x) (list 'aref x
8))
203 (defmacro tar-header-magic
(x) (list 'aref x
9))
204 (defmacro tar-header-uname
(x) (list 'aref x
10))
205 (defmacro tar-header-gname
(x) (list 'aref x
11))
206 (defmacro tar-header-dmaj
(x) (list 'aref x
12))
207 (defmacro tar-header-dmin
(x) (list 'aref x
13))
209 (defmacro make-tar-desc
(data-start tokens
)
210 (list 'cons data-start tokens
))
212 (defmacro tar-desc-data-start
(x) (list 'car x
))
213 (defmacro tar-desc-tokens
(x) (list 'cdr x
))
215 (defconst tar-name-offset
0)
216 (defconst tar-mode-offset
(+ tar-name-offset
100))
217 (defconst tar-uid-offset
(+ tar-mode-offset
8))
218 (defconst tar-gid-offset
(+ tar-uid-offset
8))
219 (defconst tar-size-offset
(+ tar-gid-offset
8))
220 (defconst tar-time-offset
(+ tar-size-offset
12))
221 (defconst tar-chk-offset
(+ tar-time-offset
12))
222 (defconst tar-linkp-offset
(+ tar-chk-offset
8))
223 (defconst tar-link-offset
(+ tar-linkp-offset
1))
224 ;;; GNU-tar specific slots.
225 (defconst tar-magic-offset
(+ tar-link-offset
100))
226 (defconst tar-uname-offset
(+ tar-magic-offset
8))
227 (defconst tar-gname-offset
(+ tar-uname-offset
32))
228 (defconst tar-dmaj-offset
(+ tar-gname-offset
32))
229 (defconst tar-dmin-offset
(+ tar-dmaj-offset
8))
230 (defconst tar-end-offset
(+ tar-dmin-offset
8))
232 (defun tar-header-block-tokenize (string)
233 "Return a `tar-header' structure.
234 This is a list of name, mode, uid, gid, size,
235 write-date, checksum, link-type, and link-name."
236 (cond ((< (length string
) 512) nil
)
237 (;(some 'plusp string) ; <-- oops, massive cycle hog!
238 (or (not (= 0 (aref string
0))) ; This will do.
239 (not (= 0 (aref string
101))))
240 (let* ((name-end (1- tar-mode-offset
))
241 (link-end (1- tar-magic-offset
))
242 (uname-end (1- tar-gname-offset
))
243 (gname-end (1- tar-dmaj-offset
))
244 (link-p (aref string tar-linkp-offset
))
245 (magic-str (substring string tar-magic-offset
(1- tar-uname-offset
)))
246 (uname-valid-p (or (string= "ustar " magic-str
) (string= "GNUtar " magic-str
)))
248 (nulsexp "[^\000]*\000"))
249 (and (string-match nulsexp string tar-name-offset
) (setq name-end
(min name-end
(1- (match-end 0)))))
250 (and (string-match nulsexp string tar-link-offset
) (setq link-end
(min link-end
(1- (match-end 0)))))
251 (and (string-match nulsexp string tar-uname-offset
) (setq uname-end
(min uname-end
(1- (match-end 0)))))
252 (and (string-match nulsexp string tar-gname-offset
) (setq gname-end
(min gname-end
(1- (match-end 0)))))
253 (setq name
(substring string tar-name-offset name-end
)
254 link-p
(if (or (= link-p
0) (= link-p ?
0))
257 (setq linkname
(substring string tar-link-offset link-end
))
258 (if default-enable-multibyte-characters
260 (decode-coding-string name
(or file-name-coding-system
263 (decode-coding-string linkname
(or file-name-coding-system
265 (if (and (null link-p
) (string-match "/$" name
)) (setq link-p
5)) ; directory
268 (tar-parse-octal-integer string tar-mode-offset
(1- tar-uid-offset
))
269 (tar-parse-octal-integer string tar-uid-offset
(1- tar-gid-offset
))
270 (tar-parse-octal-integer string tar-gid-offset
(1- tar-size-offset
))
271 (tar-parse-octal-integer string tar-size-offset
(1- tar-time-offset
))
272 (tar-parse-octal-long-integer string tar-time-offset
(1- tar-chk-offset
))
273 (tar-parse-octal-integer string tar-chk-offset
(1- tar-linkp-offset
))
277 (and uname-valid-p
(substring string tar-uname-offset uname-end
))
278 (and uname-valid-p
(substring string tar-gname-offset gname-end
))
279 (tar-parse-octal-integer string tar-dmaj-offset
(1- tar-dmin-offset
))
280 (tar-parse-octal-integer string tar-dmin-offset
(1- tar-end-offset
))
282 (t 'empty-tar-block
)))
285 (defun tar-parse-octal-integer (string &optional start end
)
286 (if (null start
) (setq start
0))
287 (if (null end
) (setq end
(length string
)))
288 (if (= (aref string start
) 0)
292 (setq n
(if (< (aref string start
) ?
0) n
293 (+ (* n
8) (- (aref string start
) ?
0)))
297 (defun tar-parse-octal-long-integer (string &optional start end
)
298 (if (null start
) (setq start
0))
299 (if (null end
) (setq end
(length string
)))
300 (if (= (aref string start
) 0)
305 (if (>= (aref string start
) ?
0)
306 (setq lo
(+ (* lo
8) (- (aref string start
) ?
0))
307 hi
(+ (* hi
8) (ash lo -
16))
308 lo
(logand lo
65535)))
309 (setq start
(1+ start
)))
312 (defun tar-parse-octal-integer-safe (string)
313 (let ((L (length string
)))
314 (if (= L
0) (error "empty string"))
316 (if (or (< (aref string i
) ?
0)
317 (> (aref string i
) ?
7))
318 (error "`%c' is not an octal digit"))))
319 (tar-parse-octal-integer string
))
322 (defun tar-header-block-checksum (string)
323 "Compute and return a tar-acceptable checksum for this block."
324 (let* ((chk-field-start tar-chk-offset
)
325 (chk-field-end (+ chk-field-start
8))
328 ;; Add up all of the characters except the ones in the checksum field.
329 ;; Add that field as if it were filled with spaces.
330 (while (< i chk-field-start
)
331 (setq sum
(+ sum
(aref string i
))
333 (setq i chk-field-end
)
335 (setq sum
(+ sum
(aref string i
))
339 (defun tar-header-block-check-checksum (hblock desired-checksum file-name
)
340 "Beep and print a warning if the checksum doesn't match."
341 (if (not (= desired-checksum
(tar-header-block-checksum hblock
)))
342 (progn (beep) (message "Invalid checksum for file %s!" file-name
))))
344 (defun tar-header-block-recompute-checksum (hblock)
345 "Modifies the given string to have a valid checksum field."
346 (let* ((chk (tar-header-block-checksum hblock
))
347 (chk-string (format "%6o" chk
))
348 (l (length chk-string
)))
351 (tar-dotimes (i l
) (aset hblock
(- 153 i
) (aref chk-string
(- l i
1)))))
354 (defun tar-clip-time-string (time)
355 (let ((str (current-time-string time
)))
356 (concat (substring str
4 16) (substring str
19 24))))
358 (defun tar-grind-file-mode (mode string start
)
359 "Store `-rw--r--r--' indicating MODE into STRING beginning at START.
360 MODE should be an integer which is a file mode value."
361 (aset string start
(if (zerop (logand 256 mode
)) ?- ?r
))
362 (aset string
(+ start
1) (if (zerop (logand 128 mode
)) ?- ?w
))
363 (aset string
(+ start
2) (if (zerop (logand 64 mode
)) ?- ?x
))
364 (aset string
(+ start
3) (if (zerop (logand 32 mode
)) ?- ?r
))
365 (aset string
(+ start
4) (if (zerop (logand 16 mode
)) ?- ?w
))
366 (aset string
(+ start
5) (if (zerop (logand 8 mode
)) ?- ?x
))
367 (aset string
(+ start
6) (if (zerop (logand 4 mode
)) ?- ?r
))
368 (aset string
(+ start
7) (if (zerop (logand 2 mode
)) ?- ?w
))
369 (aset string
(+ start
8) (if (zerop (logand 1 mode
)) ?- ?x
))
370 (if (zerop (logand 1024 mode
)) nil
(aset string
(+ start
2) ?s
))
371 (if (zerop (logand 2048 mode
)) nil
(aset string
(+ start
5) ?s
))
374 (defun tar-header-block-summarize (tar-hblock &optional mod-p
)
375 "Returns a line similar to the output of `tar -vtf'."
376 (let ((name (tar-header-name tar-hblock
))
377 (mode (tar-header-mode tar-hblock
))
378 (uid (tar-header-uid tar-hblock
))
379 (gid (tar-header-gid tar-hblock
))
380 (uname (tar-header-uname tar-hblock
))
381 (gname (tar-header-gname tar-hblock
))
382 (size (tar-header-size tar-hblock
))
383 (time (tar-header-date tar-hblock
))
384 (ck (tar-header-checksum tar-hblock
))
385 (link-p (tar-header-link-type tar-hblock
))
386 (link-name (tar-header-link-name tar-hblock
))
392 (datew (if tar-mode-show-date
18 0))
393 (slash (1- (+ left namew
)))
394 (lastdigit (+ slash groupw sizew
))
395 (datestart (+ lastdigit
2))
396 (namestart (+ datestart datew
))
397 (multibyte (or (multibyte-string-p name
)
398 (multibyte-string-p link-name
)))
399 ;; If multibyte, we can't use optimized method of aset,
400 ;; instead we must use concat.
401 (string (make-string (if multibyte
405 (if link-p
(+ 5 (length link-name
)) 0)))
407 (type (tar-header-link-type tar-hblock
)))
408 (aset string
0 (if mod-p ?
* ?
))
410 (cond ((or (eq type nil
) (eq type
0)) ?-
)
411 ((eq type
1) ?l
) ; link
412 ((eq type
2) ?s
) ; symlink
413 ((eq type
3) ?c
) ; char special
414 ((eq type
4) ?b
) ; block special
415 ((eq type
5) ?d
) ; directory
416 ((eq type
6) ?p
) ; FIFO/pipe
417 ((eq type
20) ?
*) ; directory listing
418 ((eq type
29) ?M
) ; multivolume continuation
419 ((eq type
35) ?S
) ; sparse
420 ((eq type
38) ?V
) ; volume header
422 (tar-grind-file-mode mode string
2)
423 (setq uid
(if (= 0 (length uname
)) (int-to-string uid
) uname
))
424 (setq gid
(if (= 0 (length gname
)) (int-to-string gid
) gname
))
425 (setq size
(int-to-string size
))
426 (setq time
(tar-clip-time-string time
))
427 (tar-dotimes (i (min (1- namew
) (length uid
))) (aset string
(- slash i
) (aref uid
(- (length uid
) i
1))))
428 (aset string
(1+ slash
) ?
/)
429 (tar-dotimes (i (min (1- groupw
) (length gid
))) (aset string
(+ (+ slash
2) i
) (aref gid i
)))
430 (tar-dotimes (i (min sizew
(length size
))) (aset string
(- lastdigit i
) (aref size
(- (length size
) i
1))))
431 (if tar-mode-show-date
432 (tar-dotimes (i (length time
)) (aset string
(+ datestart i
) (aref time i
))))
434 (setq string
(concat string name
))
435 (tar-dotimes (i (length name
)) (aset string
(+ namestart i
) (aref name i
))))
436 (if (or (eq link-p
1) (eq link-p
2))
438 (setq string
(concat string
439 (if (= link-p
1) " ==> " " --> ")
441 (tar-dotimes (i 3) (aset string
(+ namestart
1 (length name
) i
) (aref (if (= link-p
1) "==>" "-->") i
)))
442 (tar-dotimes (i (length link-name
)) (aset string
(+ namestart
5 (length name
) i
) (aref link-name i
)))))
443 (put-text-property namestart
(length string
)
444 'mouse-face
'highlight string
)
448 (defun tar-summarize-buffer ()
449 "Parse the contents of the tar file in the current buffer.
450 Place a dired-like listing on the front;
451 then narrow to it, so that only that listing
452 is visible (and the real data of the buffer is hidden)."
453 (set-buffer-multibyte nil
)
454 (message "Parsing tar file...")
457 (bs (max 1 (- (buffer-size) 1024))) ; always 2+ empty blocks at end.
458 (bs100 (max 1 (/ bs
100)))
460 (while (and (<= (+ pos
512) (point-max))
461 (not (eq 'empty-tar-block
463 (tar-header-block-tokenize
464 (buffer-substring pos
(+ pos
512)))))))
465 (setq pos
(+ pos
512))
466 (message "Parsing tar file...%d%%"
467 ;(/ (* pos 100) bs) ; this gets round-off lossage
468 (/ pos bs100
) ; this doesn't
470 (if (eq (tar-header-link-type tokens
) 20)
471 ;; Foo. There's an extra empty block after these.
472 (setq pos
(+ pos
512)))
473 (let ((size (tar-header-size tokens
)))
475 (error "%s has size %s - corrupted"
476 (tar-header-name tokens
) size
))
478 ; This is just too slow. Don't really need it anyway....
479 ;(tar-header-block-check-checksum
480 ; hblock (tar-header-block-checksum hblock)
481 ; (tar-header-name tokens))
483 (setq result
(cons (make-tar-desc pos tokens
) result
))
485 (and (null (tar-header-link-type tokens
))
488 (+ pos
512 (ash (ash (1- size
) -
9) 9)) ; this works
489 ;(+ pos (+ size (- 512 (rem (1- size) 512)))) ; this doesn't
491 (make-local-variable 'tar-parse-info
)
492 (setq tar-parse-info
(nreverse result
))
493 ;; A tar file should end with a block or two of nulls,
494 ;; but let's not get a fatal error if it doesn't.
495 (if (eq tokens
'empty-tar-block
)
496 (message "Parsing tar file...done")
497 (message "Warning: premature EOF parsing tar file")))
499 (goto-char (point-min))
500 (let ((buffer-read-only nil
)
502 ;; Collect summary lines and insert them all at once since tar files
503 ;; can be pretty big.
504 (tar-dolist (tar-desc (reverse tar-parse-info
))
506 (cons (tar-header-block-summarize (tar-desc-tokens tar-desc
))
509 (let ((total-summaries (apply 'concat summaries
)))
510 (if (multibyte-string-p total-summaries
)
511 (set-buffer-multibyte t
))
512 (insert total-summaries
))
513 (make-local-variable 'tar-header-offset
)
514 (setq tar-header-offset
(point))
515 (narrow-to-region 1 tar-header-offset
)
516 (if enable-multibyte-characters
517 (setq tar-header-offset
(position-bytes tar-header-offset
)))
518 (set-buffer-modified-p nil
))))
520 (defvar tar-mode-map nil
"*Local keymap for Tar mode listings.")
524 (setq tar-mode-map
(make-keymap))
525 (suppress-keymap tar-mode-map
)
526 (define-key tar-mode-map
" " 'tar-next-line
)
527 (define-key tar-mode-map
"C" 'tar-copy
)
528 (define-key tar-mode-map
"d" 'tar-flag-deleted
)
529 (define-key tar-mode-map
"\^D" 'tar-flag-deleted
)
530 (define-key tar-mode-map
"e" 'tar-extract
)
531 (define-key tar-mode-map
"f" 'tar-extract
)
532 (define-key tar-mode-map
"\C-m" 'tar-extract
)
533 (define-key tar-mode-map
[mouse-2
] 'tar-mouse-extract
)
534 (define-key tar-mode-map
"g" 'revert-buffer
)
535 (define-key tar-mode-map
"h" 'describe-mode
)
536 (define-key tar-mode-map
"n" 'tar-next-line
)
537 (define-key tar-mode-map
"\^N" 'tar-next-line
)
538 (define-key tar-mode-map
[down] 'tar-next-line)
539 (define-key tar-mode-map "o" 'tar-extract-other-window)
540 (define-key tar-mode-map "p" 'tar-previous-line)
541 (define-key tar-mode-map "q" 'tar-quit)
542 (define-key tar-mode-map "\^P" 'tar-previous-line)
543 (define-key tar-mode-map [up] 'tar-previous-line)
544 (define-key tar-mode-map "R" 'tar-rename-entry)
545 (define-key tar-mode-map "u" 'tar-unflag)
546 (define-key tar-mode-map "v" 'tar-view)
547 (define-key tar-mode-map "x" 'tar-expunge)
548 (define-key tar-mode-map "\177" 'tar-unflag-backwards)
549 (define-key tar-mode-map "E" 'tar-extract-other-window)
550 (define-key tar-mode-map "M" 'tar-chmod-entry)
551 (define-key tar-mode-map "G" 'tar-chgrp-entry)
552 (define-key tar-mode-map "O" 'tar-chown-entry)
555 ;; Make menu bar items.
557 ;; Get rid of the Edit menu bar item to save space.
558 (define-key tar-mode-map [menu-bar edit] 'undefined)
560 (define-key tar-mode-map [menu-bar immediate]
561 (cons "Immediate" (make-sparse-keymap "Immediate")))
563 (define-key tar-mode-map [menu-bar immediate view]
564 '("View This File" . tar-view))
565 (define-key tar-mode-map [menu-bar immediate display]
566 '("Display in Other Window" . tar-display-other-window))
567 (define-key tar-mode-map [menu-bar immediate find-file-other-window]
568 '("Find in Other Window" . tar-extract-other-window))
569 (define-key tar-mode-map [menu-bar immediate find-file]
570 '("Find This File" . tar-extract))
572 (define-key tar-mode-map [menu-bar mark]
573 (cons "Mark" (make-sparse-keymap "Mark")))
575 (define-key tar-mode-map [menu-bar mark unmark-all]
576 '("Unmark All" . tar-clear-modification-flags))
577 (define-key tar-mode-map [menu-bar mark deletion]
578 '("Flag" . tar-flag-deleted))
579 (define-key tar-mode-map [menu-bar mark unmark]
580 '("Unflag" . tar-unflag))
582 (define-key tar-mode-map [menu-bar operate]
583 (cons "Operate" (make-sparse-keymap "Operate")))
585 (define-key tar-mode-map [menu-bar operate chown]
586 '("Change Owner..." . tar-chown-entry))
587 (define-key tar-mode-map [menu-bar operate chgrp]
588 '("Change Group..." . tar-chgrp-entry))
589 (define-key tar-mode-map [menu-bar operate chmod]
590 '("Change Mode..." . tar-chmod-entry))
591 (define-key tar-mode-map [menu-bar operate rename]
592 '("Rename to..." . tar-rename-entry))
593 (define-key tar-mode-map [menu-bar operate copy]
594 '("Copy to..." . tar-copy))
595 (define-key tar-mode-map [menu-bar operate expunge]
596 '("Expunge Marked Files" . tar-expunge))
598 ;; tar mode is suitable only for specially formatted data.
599 (put 'tar-mode 'mode-class 'special)
600 (put 'tar-subfile-mode 'mode-class 'special)
604 "Major mode for viewing a tar file as a dired-like listing of its contents.
605 You can move around using the usual cursor motion commands.
606 Letters no longer insert themselves.
607 Type `e' to pull a file out of the tar file and into its own buffer;
608 or click mouse-2 on the file's line in the Tar mode buffer.
609 Type `c' to copy an entry from the tar file into another file on disk.
611 If you edit a sub-file of this archive (as with the `e' command) and
612 save it with Control-x Control-s, the contents of that buffer will be
613 saved back into the tar-file buffer; in this way you can edit a file
614 inside of a tar archive without extracting it and re-archiving it.
616 See also: variables `tar-update-datestamp' and `tar-anal-blocksize'.
618 ;; this is not interactive because you shouldn't be turning this
619 ;; mode on and off. You can corrupt things that way.
620 ;; rms: with permanent locals, it should now be possible to make this work
621 ;; interactively in some reasonable fashion.
622 (kill-all-local-variables)
623 (make-local-variable 'tar-header-offset)
624 (make-local-variable 'tar-parse-info)
625 (make-local-variable 'require-final-newline)
626 (setq require-final-newline nil) ; binary data, dude...
627 (make-local-variable 'revert-buffer-function)
628 (setq revert-buffer-function 'tar-mode-revert)
629 (make-local-variable 'local-enable-local-variables)
630 (setq local-enable-local-variables nil)
631 (make-local-variable 'next-line-add-newlines)
632 (setq next-line-add-newlines nil)
633 ;; Prevent loss of data when saving the file.
634 (make-local-variable 'file-precious-flag)
635 (setq file-precious-flag t)
636 (setq major-mode 'tar-mode)
637 (setq mode-name "Tar")
638 (use-local-map tar-mode-map)
640 (make-local-variable 'write-contents-hooks)
641 (setq write-contents-hooks '(tar-mode-write-file))
643 (if (and (boundp 'tar-header-offset) tar-header-offset)
644 (narrow-to-region 1 (byte-to-position tar-header-offset))
645 (tar-summarize-buffer)
647 (run-hooks 'tar-mode-hook)
651 (defun tar-subfile-mode (p)
652 "Minor mode for editing an element of a tar-file.
653 This mode arranges for \"saving\" this buffer to write the data
654 into the tar-file buffer that it came from. The changes will actually
655 appear on disk when you save the tar-file's buffer."
657 (or (and (boundp 'tar-superior-buffer) tar-superior-buffer)
658 (error "This buffer is not an element of a tar file"))
659 ;;; Don't do this, because it is redundant and wastes mode line space.
660 ;;; (or (assq 'tar-subfile-mode minor-mode-alist)
661 ;;; (setq minor-mode-alist (append minor-mode-alist
662 ;;; (list '(tar-subfile-mode " TarFile")))))
663 (make-local-variable 'tar-subfile-mode)
664 (setq tar-subfile-mode
666 (not tar-subfile-mode)
667 (> (prefix-numeric-value p) 0)))
668 (cond (tar-subfile-mode
669 (make-local-variable 'local-write-file-hooks)
670 (setq local-write-file-hooks '(tar-subfile-save-buffer))
671 ;; turn off auto-save.
673 (setq buffer-auto-save-file-name nil)
674 (run-hooks 'tar-subfile-mode-hook))
676 (kill-local-variable 'local-write-file-hooks))))
679 ;; Revert the buffer and recompute the dired-like listing.
680 (defun tar-mode-revert (&optional no-auto-save no-confirm)
681 (let ((revert-buffer-function nil)
682 (old-offset tar-header-offset)
684 (setq tar-header-offset nil)
686 (and (revert-buffer t no-confirm)
690 ;; If the revert was canceled,
691 ;; put back the old value of tar-header-offset.
693 (setq tar-header-offset old-offset)))))
696 (defun tar-next-line (p)
699 (if (eobp) nil (forward-char (if tar-mode-show-date 54 36))))
701 (defun tar-previous-line (p)
703 (tar-next-line (- p)))
705 (defun tar-current-descriptor (&optional noerror)
706 "Return the tar-descriptor of the current line, or signals an error."
707 ;; I wish lines had plists, like in ZMACS...
708 (or (nth (count-lines (point-min)
709 (save-excursion (beginning-of-line) (point)))
713 (error "This line does not describe a tar-file entry"))))
715 (defun tar-get-descriptor ()
716 (let* ((descriptor (tar-current-descriptor))
717 (tokens (tar-desc-tokens descriptor))
718 (size (tar-header-size tokens))
719 (link-p (tar-header-link-type tokens)))
721 (error "This is a %s, not a real file"
722 (cond ((eq link-p 5) "directory")
723 ((eq link-p 20) "tar directory header")
724 ((eq link-p 29) "multivolume-continuation")
725 ((eq link-p 35) "sparse entry")
726 ((eq link-p 38) "volume header")
728 (if (zerop size) (error "This is a zero-length file"))
731 (defun tar-mouse-extract (event)
732 "Extract a file whose tar directory line you click on."
735 (set-buffer (window-buffer (posn-window (event-end event))))
737 (goto-char (posn-point (event-end event)))
738 ;; Just make sure this doesn't get an error.
739 (tar-get-descriptor)))
740 (select-window (posn-window (event-end event)))
741 (goto-char (posn-point (event-end event)))
744 (defun tar-extract (&optional other-window-p)
745 "In Tar mode, extract this entry of the tar file into its own buffer."
747 (let* ((view-p (eq other-window-p 'view))
748 (descriptor (tar-get-descriptor))
749 (tokens (tar-desc-tokens descriptor))
750 (name (tar-header-name tokens))
751 (size (tar-header-size tokens))
752 (start (+ (tar-desc-data-start descriptor) tar-header-offset -1))
753 (end (+ start size)))
754 (let* ((tar-buffer (current-buffer))
755 (tar-buffer-multibyte enable-multibyte-characters)
756 (tarname (file-name-nondirectory (buffer-file-name)))
757 (bufname (concat (file-name-nondirectory name)
761 (read-only-p (or buffer-read-only view-p))
762 (buffer (get-buffer bufname))
766 (setq buffer (get-buffer-create bufname))
767 (setq just-created t)
771 (set-buffer-multibyte nil)
774 (if enable-multibyte-characters
776 ;; We must avoid unibyte->multibyte conversion.
777 (set-buffer-multibyte nil)
778 (insert-buffer-substring tar-buffer start end)
779 (set-buffer-multibyte t))
780 (insert-buffer-substring tar-buffer start end))
782 (setq buffer-file-name
783 ;; `:' is not allowed on Windows
784 (expand-file-name (concat tarname "!" name)))
785 (setq buffer-file-truename
786 (abbreviate-file-name buffer-file-name))
787 ;; We need to mimic the parts of insert-file-contents
788 ;; which determine the coding-system and decode the text.
790 (and set-auto-coding-function
792 (funcall set-auto-coding-function
794 (multibyte enable-multibyte-characters)
795 (detected (detect-coding-region
796 1 (min 16384 (point-max)) t)))
798 (or (numberp (coding-system-eol-type coding))
799 (setq coding (coding-system-change-eol-conversion
801 (coding-system-eol-type detected))))
803 (or (find-new-buffer-file-coding-system detected)
805 (find-operation-coding-system
806 'insert-file-contents buffer-file-name)))
807 (if (consp file-coding)
808 (setq file-coding (car file-coding))
810 (if (or (eq coding 'no-conversion)
811 (eq (coding-system-type coding) 5))
812 (setq multibyte (set-buffer-multibyte nil)))
815 (coding-system-change-text-conversion
817 (decode-coding-region 1 (point-max) coding)
818 (set-buffer-file-coding-system coding))
819 ;; Set the default-directory to the dir of the
821 (setq default-directory
823 (set-buffer tar-buffer)
825 (normal-mode) ; pick a mode.
826 (rename-buffer bufname)
827 (make-local-variable 'tar-superior-buffer)
828 (make-local-variable 'tar-superior-descriptor)
829 (setq tar-superior-buffer tar-buffer)
830 (setq tar-superior-descriptor descriptor)
831 (setq buffer-read-only read-only-p)
832 (set-buffer-modified-p nil)
833 (tar-subfile-mode 1))
834 (set-buffer tar-buffer))
835 (narrow-to-region 1 tar-header-offset)
836 (set-buffer-multibyte tar-buffer-multibyte)))
838 (view-buffer buffer (and just-created 'kill-buffer))
839 (if (eq other-window-p 'display)
840 (display-buffer buffer)
842 (switch-to-buffer-other-window buffer)
843 (switch-to-buffer buffer)))))))
846 (defun tar-extract-other-window ()
847 "*In Tar mode, find this entry of the tar file in another window."
851 (defun tar-display-other-window ()
852 "*In Tar mode, display this entry of the tar file in another window."
854 (tar-extract 'display))
857 "*In Tar mode, view the tar file entry on this line."
862 (defun tar-read-file-name (&optional prompt)
863 "Read a file name with this line's entry as the default."
864 (or prompt (setq prompt "Copy to: "))
865 (let* ((default-file (expand-file-name
866 (tar-header-name (tar-desc-tokens
867 (tar-current-descriptor)))))
868 (target (expand-file-name
869 (read-file-name prompt
870 (file-name-directory default-file)
872 (if (or (string= "" (file-name-nondirectory target))
873 (file-directory-p target))
874 (setq target (concat (if (string-match "/$" target)
875 (substring target 0 (1- (match-end 0)))
878 (file-name-nondirectory default-file))))
882 (defun tar-copy (&optional to-file)
883 "*In Tar mode, extract this entry of the tar file into a file on disk.
884 If TO-FILE is not supplied, it is prompted for, defaulting to the name of
885 the current tar-entry."
886 (interactive (list (tar-read-file-name)))
887 (let* ((descriptor (tar-get-descriptor))
888 (tokens (tar-desc-tokens descriptor))
889 (name (tar-header-name tokens))
890 (size (tar-header-size tokens))
891 (start (+ (tar-desc-data-start descriptor) tar-header-offset -1))
893 (multibyte enable-multibyte-characters)
894 (inhibit-file-name-handlers inhibit-file-name-handlers)
895 (inhibit-file-name-operation inhibit-file-name-operation))
898 ;; Inhibit compressing a subfile again if *both* name and
899 ;; to-file are handled by jka-compr
900 (if (and (eq (find-file-name-handler name 'write-region) 'jka-compr-handler)
901 (eq (find-file-name-handler to-file 'write-region) 'jka-compr-handler))
902 (setq inhibit-file-name-handlers
903 (cons 'jka-compr-handler
904 (and (eq inhibit-file-name-operation 'write-region)
905 inhibit-file-name-handlers))
906 inhibit-file-name-operation 'write-region))
908 (let ((coding-system-for-write 'no-conversion))
909 (set-buffer-multibyte nil)
910 (write-region start end to-file))
911 (set-buffer-multibyte multibyte)))
912 (message "Copied tar entry %s to %s" name to-file)))
914 (defun tar-flag-deleted (p &optional unflag)
915 "*In Tar mode, mark this sub-file to be deleted from the tar file.
916 With a prefix argument, mark that many files."
919 (tar-dotimes (i (if (< p 0) (- p) p))
920 (if (tar-current-descriptor unflag) ; barf if we're not on an entry-line.
923 (insert (if unflag " " "D"))))
924 (forward-line (if (< p 0) -1 1)))
925 (if (eobp) nil (forward-char 36)))
927 (defun tar-unflag (p)
928 "*In Tar mode, un-mark this sub-file if it is marked to be deleted.
929 With a prefix argument, un-mark that many files forward."
931 (tar-flag-deleted p t))
933 (defun tar-unflag-backwards (p)
934 "*In Tar mode, un-mark this sub-file if it is marked to be deleted.
935 With a prefix argument, un-mark that many files backward."
937 (tar-flag-deleted (- p) t))
940 ;; When this function is called, it is sure that the buffer is unibyte.
941 (defun tar-expunge-internal ()
942 "Expunge the tar-entry specified by the current line."
943 (let* ((descriptor (tar-current-descriptor))
944 (tokens (tar-desc-tokens descriptor))
945 (line (tar-desc-data-start descriptor))
946 (name (tar-header-name tokens))
947 (size (tar-header-size tokens))
948 (link-p (tar-header-link-type tokens))
949 (start (tar-desc-data-start descriptor))
950 (following-descs (cdr (memq descriptor tar-parse-info))))
951 (if link-p (setq size 0)) ; size lies for hard-links.
953 ;; delete the current line...
955 (let ((line-start (point)))
956 (end-of-line) (forward-char)
957 (let ((line-len (- (point) line-start)))
958 (delete-region line-start (point))
960 ;; decrement the header-pointer to be in sync...
961 (setq tar-header-offset (- tar-header-offset line-len))))
963 ;; delete the data pointer...
964 (setq tar-parse-info (delq descriptor tar-parse-info))
966 ;; delete the data from inside the file...
968 (let* ((data-start (+ start tar-header-offset -513))
969 (data-end (+ data-start 512 (ash (ash (+ size 511) -9) 9))))
970 (delete-region data-start data-end)
972 ;; and finally, decrement the start-pointers of all following
973 ;; entries in the archive. This is a pig when deleting a bunch
974 ;; of files at once - we could optimize this to only do the
975 ;; iteration over the files that remain, or only iterate up to
976 ;; the next file to be deleted.
977 (let ((data-length (- data-end data-start)))
978 (tar-dolist (desc following-descs)
979 (tar-setf (tar-desc-data-start desc)
980 (- (tar-desc-data-start desc) data-length))))
982 (narrow-to-region 1 tar-header-offset))
985 (defun tar-expunge (&optional noconfirm)
986 "*In Tar mode, delete all the archived files flagged for deletion.
987 This does not modify the disk image; you must save the tar file itself
988 for this to be permanent."
991 (y-or-n-p "Expunge files marked for deletion? "))
993 (multibyte enable-multibyte-characters))
994 (set-buffer-multibyte nil)
999 (progn (tar-expunge-internal)
1002 ;; after doing the deletions, add any padding that may be necessary.
1003 (tar-pad-to-blocksize)
1004 (narrow-to-region 1 tar-header-offset))
1005 (set-buffer-multibyte multibyte)
1007 (message "Nothing to expunge.")
1008 (message "%s files expunged. Be sure to save this buffer." n)))))
1011 (defun tar-clear-modification-flags ()
1012 "Remove the stars at the beginning of each line."
1016 (while (< (position-bytes (point)) tar-header-offset)
1017 (if (not (eq (following-char) ?\ ))
1018 (progn (delete-char 1) (insert " ")))
1022 (defun tar-chown-entry (new-uid)
1023 "*Change the user-id associated with this entry in the tar file.
1024 If this tar file was written by GNU tar, then you will be able to edit
1025 the user id as a string; otherwise, you must edit it as a number.
1026 You can force editing as a number by calling this with a prefix arg.
1027 This does not modify the disk image; you must save the tar file itself
1028 for this to be permanent."
1030 (let ((tokens (tar-desc-tokens (tar-current-descriptor))))
1031 (if (or current-prefix-arg
1032 (not (tar-header-magic tokens)))
1034 (while (not (numberp (setq n (read-minibuffer
1036 (format "%s" (tar-header-uid tokens)))))))
1038 (read-string "New UID string: " (tar-header-uname tokens))))))
1039 (cond ((stringp new-uid)
1040 (tar-setf (tar-header-uname (tar-desc-tokens (tar-current-descriptor)))
1042 (tar-alter-one-field tar-uname-offset (concat new-uid "\000")))
1044 (tar-setf (tar-header-uid (tar-desc-tokens (tar-current-descriptor)))
1046 (tar-alter-one-field tar-uid-offset
1047 (concat (substring (format "%6o" new-uid) 0 6) "\000 ")))))
1050 (defun tar-chgrp-entry (new-gid)
1051 "*Change the group-id associated with this entry in the tar file.
1052 If this tar file was written by GNU tar, then you will be able to edit
1053 the group id as a string; otherwise, you must edit it as a number.
1054 You can force editing as a number by calling this with a prefix arg.
1055 This does not modify the disk image; you must save the tar file itself
1056 for this to be permanent."
1058 (let ((tokens (tar-desc-tokens (tar-current-descriptor))))
1059 (if (or current-prefix-arg
1060 (not (tar-header-magic tokens)))
1062 (while (not (numberp (setq n (read-minibuffer
1064 (format "%s" (tar-header-gid tokens)))))))
1066 (read-string "New GID string: " (tar-header-gname tokens))))))
1067 (cond ((stringp new-gid)
1068 (tar-setf (tar-header-gname (tar-desc-tokens (tar-current-descriptor)))
1070 (tar-alter-one-field tar-gname-offset
1071 (concat new-gid "\000")))
1073 (tar-setf (tar-header-gid (tar-desc-tokens (tar-current-descriptor)))
1075 (tar-alter-one-field tar-gid-offset
1076 (concat (substring (format "%6o" new-gid) 0 6) "\000 ")))))
1078 (defun tar-rename-entry (new-name)
1079 "*Change the name associated with this entry in the tar file.
1080 This does not modify the disk image; you must save the tar file itself
1081 for this to be permanent."
1083 (list (read-string "New name: "
1084 (tar-header-name (tar-desc-tokens (tar-current-descriptor))))))
1085 (if (string= "" new-name) (error "zero length name"))
1086 (if (> (length new-name) 98) (error "name too long"))
1087 (tar-setf (tar-header-name (tar-desc-tokens (tar-current-descriptor)))
1089 (tar-alter-one-field 0
1090 (substring (concat new-name (make-string 99 0)) 0 99)))
1093 (defun tar-chmod-entry (new-mode)
1094 "*Change the protection bits associated with this entry in the tar file.
1095 This does not modify the disk image; you must save the tar file itself
1096 for this to be permanent."
1097 (interactive (list (tar-parse-octal-integer-safe
1098 (read-string "New protection (octal): "))))
1099 (tar-setf (tar-header-mode (tar-desc-tokens (tar-current-descriptor)))
1101 (tar-alter-one-field tar-mode-offset
1102 (concat (substring (format "%6o" new-mode) 0 6) "\000 ")))
1105 (defun tar-alter-one-field (data-position new-data-string)
1106 (let* ((descriptor (tar-current-descriptor))
1107 (tokens (tar-desc-tokens descriptor))
1108 (multibyte enable-multibyte-characters))
1112 ;; update the header-line.
1116 (delete-region p (point))
1117 (insert (tar-header-block-summarize tokens) "\n")
1118 (setq tar-header-offset (position-bytes (point-max))))
1121 (set-buffer-multibyte nil)
1122 (let* ((start (+ (tar-desc-data-start descriptor) tar-header-offset -513)))
1124 ;; delete the old field and insert a new one.
1125 (goto-char (+ start data-position))
1126 (delete-region (point) (+ (point) (length new-data-string))) ; <--
1127 (insert new-data-string) ; <--
1129 ;; compute a new checksum and insert it.
1130 (let ((chk (tar-header-block-checksum
1131 (buffer-substring start (+ start 512)))))
1132 (goto-char (+ start tar-chk-offset))
1133 (delete-region (point) (+ (point) 8))
1134 (insert (format "%6o" chk))
1137 (tar-setf (tar-header-checksum tokens) chk)
1139 ;; ok, make sure we didn't botch it.
1140 (tar-header-block-check-checksum
1141 (buffer-substring start (+ start 512))
1142 chk (tar-header-name tokens))
1144 (narrow-to-region 1 tar-header-offset)
1145 (set-buffer-multibyte multibyte)
1146 (tar-next-line 0))))
1149 (defun tar-octal-time (timeval)
1150 ;; Format a timestamp as 11 octal digits. Ghod, I hope this works...
1151 (let ((hibits (car timeval)) (lobits (car (cdr timeval))))
1152 (insert (format "%05o%01o%05o"
1154 (logior (lsh (logand 3 hibits) 1) (> (logand lobits 32768) 0))
1155 (logand 32767 lobits)
1158 (defun tar-subfile-save-buffer ()
1159 "In tar subfile mode, save this buffer into its parent tar-file buffer.
1160 This doesn't write anything to disk; you must save the parent tar-file buffer
1161 to make your changes permanent."
1163 (if (not (and (boundp 'tar-superior-buffer) tar-superior-buffer))
1164 (error "This buffer has no superior tar file buffer"))
1165 (if (not (and (boundp 'tar-superior-descriptor) tar-superior-descriptor))
1166 (error "This buffer doesn't have an index into its superior tar file!"))
1168 (let ((subfile (current-buffer))
1169 (subfile-multibyte enable-multibyte-characters)
1170 (coding buffer-file-coding-system)
1171 (descriptor tar-superior-descriptor)
1173 ;; We must make the current buffer unibyte temporarily to avoid
1174 ;; multibyte->unibyte conversion in `insert-buffer'.
1175 (set-buffer-multibyte nil)
1176 (setq subfile-size (buffer-size))
1177 (set-buffer tar-superior-buffer)
1178 (let* ((tokens (tar-desc-tokens descriptor))
1179 (start (tar-desc-data-start descriptor))
1180 (name (tar-header-name tokens))
1181 (size (tar-header-size tokens))
1182 (size-pad (ash (ash (+ size 511) -9) 9))
1183 (head (memq descriptor tar-parse-info))
1184 (following-descs (cdr head))
1185 (tar-buffer-multibyte enable-multibyte-characters))
1187 (error "Can't find this tar file entry in its parent tar file!"))
1191 (set-buffer-multibyte nil)
1192 ;; delete the old data...
1193 (let* ((data-start (+ start tar-header-offset -1))
1194 (data-end (+ data-start (ash (ash (+ size 511) -9) 9))))
1195 (delete-region data-start data-end)
1196 ;; insert the new data...
1197 (goto-char data-start)
1198 (insert-buffer subfile)
1200 (encode-coding-region
1201 data-start (+ data-start subfile-size) coding))
1203 ;; pad the new data out to a multiple of 512...
1204 (let ((subfile-size-pad (ash (ash (+ subfile-size 511) -9) 9)))
1205 (goto-char (+ data-start subfile-size))
1206 (insert (make-string (- subfile-size-pad subfile-size) 0))
1208 ;; update the data pointer of this and all following files...
1209 (tar-setf (tar-header-size tokens) subfile-size)
1210 (let ((difference (- subfile-size-pad size-pad)))
1211 (tar-dolist (desc following-descs)
1212 (tar-setf (tar-desc-data-start desc)
1213 (+ (tar-desc-data-start desc) difference))))
1215 ;; Update the size field in the header block.
1216 (let ((header-start (- data-start 512)))
1217 (goto-char (+ header-start tar-size-offset))
1218 (delete-region (point) (+ (point) 12))
1219 (insert (format "%11o" subfile-size))
1222 ;; Maybe update the datestamp.
1223 (if (not tar-update-datestamp)
1225 (goto-char (+ header-start tar-time-offset))
1226 (delete-region (point) (+ (point) 12))
1227 (insert (tar-octal-time (current-time)))
1230 ;; compute a new checksum and insert it.
1231 (let ((chk (tar-header-block-checksum
1232 (buffer-substring header-start data-start))))
1233 (goto-char (+ header-start tar-chk-offset))
1234 (delete-region (point) (+ (point) 8))
1235 (insert (format "%6o" chk))
1238 (tar-setf (tar-header-checksum tokens) chk)))
1240 ;; alter the descriptor-line...
1242 (let ((position (- (length tar-parse-info) (length head))))
1244 (next-line position)
1248 (m (set-marker (make-marker) tar-header-offset)))
1250 (setq after (point))
1251 ;; Insert the new text after the old, before deleting,
1252 ;; to preserve the window start.
1253 (let ((line (tar-header-block-summarize tokens t)))
1254 (if (multibyte-string-p line)
1255 (insert-before-markers (string-as-unibyte line) "\n")
1256 (insert-before-markers line "\n")))
1257 (delete-region p after)
1258 (setq tar-header-offset (marker-position m)))
1260 ;; after doing the insertion, add any final padding that may be necessary.
1261 (tar-pad-to-blocksize))
1262 (narrow-to-region 1 tar-header-offset)
1263 (set-buffer-multibyte tar-buffer-multibyte)))
1264 (set-buffer-modified-p t) ; mark the tar file as modified
1266 (set-buffer subfile)
1267 ;; Restore the buffer multibyteness.
1268 (set-buffer-multibyte subfile-multibyte)
1269 (set-buffer-modified-p nil) ; mark the tar subfile as unmodified
1270 (message "Saved into tar-buffer `%s'. Be sure to save that buffer!"
1271 (buffer-name tar-superior-buffer))
1272 ;; Prevent basic-save-buffer from changing our coding-system.
1273 (setq last-coding-system-used buffer-file-coding-system)
1274 ;; Prevent ordinary saving from happening.
1278 ;; When this function is called, it is sure that the buffer is unibyte.
1279 (defun tar-pad-to-blocksize ()
1280 "If we are being anal about tar file blocksizes, fix up the current buffer.
1281 Leaves the region wide."
1282 (if (null tar-anal-blocksize)
1285 (let* ((last-desc (nth (1- (length tar-parse-info)) tar-parse-info))
1286 (start (tar-desc-data-start last-desc))
1287 (tokens (tar-desc-tokens last-desc))
1288 (link-p (tar-header-link-type tokens))
1289 (size (if link-p 0 (tar-header-size tokens)))
1290 (data-end (+ start size))
1291 (bbytes (ash tar-anal-blocksize 9))
1292 (pad-to (+ bbytes (* bbytes (/ (1- data-end) bbytes))))
1293 (inhibit-read-only t) ; ##
1295 ;; If the padding after the last data is too long, delete some;
1296 ;; else insert some until we are padded out to the right number of blocks.
1298 (goto-char (+ (or tar-header-offset 0) data-end))
1299 (if (> (1+ (buffer-size)) (+ (or tar-header-offset 0) pad-to))
1300 (delete-region (+ (or tar-header-offset 0) pad-to) (1+ (buffer-size)))
1301 (insert (make-string (- (+ (or tar-header-offset 0) pad-to)
1307 ;; Used in write-file-hook to write tar-files out correctly.
1308 (defun tar-mode-write-file ()
1312 ;; Doing this here confuses things - the region gets left too wide!
1313 ;; I suppose this is run in a context where changing the buffer is bad.
1314 ;; (tar-pad-to-blocksize)
1315 ;; tar-header-offset turns out to be null for files fetched with W3,
1317 (let ((coding-system-for-write 'no-conversion))
1318 (write-region (or (byte-to-position tar-header-offset)
1321 buffer-file-name nil t))
1322 (tar-clear-modification-flags)
1323 (set-buffer-modified-p nil))
1324 (narrow-to-region 1 (byte-to-position tar-header-offset)))
1325 ;; return T because we've written the file.
1329 "Kill the current tar buffer."
1336 ;;; tar-mode.el ends here