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>
6 ;; Created: 04 Apr 1990
9 ;; This file is part of GNU Emacs.
11 ;; GNU Emacs is free software; you can redistribute it and/or modify
12 ;; it under the terms of the GNU General Public License as published by
13 ;; the Free Software Foundation; either version 2, or (at your option)
16 ;; GNU Emacs is distributed in the hope that it will be useful,
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 ;; GNU General Public License for more details.
21 ;; You should have received a copy of the GNU General Public License
22 ;; along with GNU Emacs; see the file COPYING. If not, write to the
23 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
24 ;; Boston, MA 02111-1307, USA.
28 ;; This package attempts to make dealing with Unix 'tar' archives easier.
29 ;; When this code is loaded, visiting a file whose name ends in '.tar' will
30 ;; cause the contents of that archive file to be displayed in a Dired-like
31 ;; listing. It is then possible to use the customary Dired keybindings to
32 ;; extract sub-files from that archive, either by reading them into their own
33 ;; editor buffers, or by copying them directly to arbitrary files on disk.
34 ;; It is also possible to delete sub-files from within the tar file and write
35 ;; the modified archive back to disk, or to edit sub-files within the archive
36 ;; and re-insert the modified files into the archive. See the documentation
37 ;; string of tar-mode for more info.
39 ;; This code now understands the extra fields that GNU tar adds to tar files.
41 ;; This interacts correctly with "uncompress.el" in the Emacs library,
44 ;; (autoload 'uncompress-while-visiting "uncompress")
45 ;; (setq auto-mode-alist (cons '("\\.Z$" . uncompress-while-visiting)
48 ;; Do not attempt to use tar-mode.el with crypt.el, you will lose.
50 ;; *************** TO DO ***************
52 ;; o chmod should understand "a+x,og-w".
54 ;; o It's not possible to add a NEW file to a tar archive; not that
55 ;; important, but still...
57 ;; o The code is less efficient that it could be - in a lot of places, I
58 ;; pull a 512-character string out of the buffer and parse it, when I could
59 ;; be parsing it in place, not garbaging a string. Should redo that.
61 ;; o I'd like a command that searches for a string/regexp in every subfile
62 ;; of an archive, where <esc> would leave you in a subfile-edit buffer.
63 ;; (Like the Meta-R command of the Zmacs mail reader.)
65 ;; o Sometimes (but not always) reverting the tar-file buffer does not
66 ;; re-grind the listing, and you are staring at the binary tar data.
67 ;; Typing 'g' again immediately after that will always revert and re-grind
68 ;; it, though. I have no idea why this happens.
70 ;; o Tar-mode interacts poorly with crypt.el and zcat.el because the tar
71 ;; write-file-hook actually writes the file. Instead it should remove the
72 ;; header (and conspire to put it back afterwards) so that other write-file
73 ;; hooks which frob the buffer have a chance to do their dirty work. There
74 ;; might be a problem if the tar write-file-hook does not come *first* on
77 ;; o Block files, sparse files, continuation files, and the various header
78 ;; types aren't editable. Actually I don't know that they work at all.
82 ;; Why does tar-mode edit the file itself instead of using tar?
84 ;; That means that you can edit tar files which you don't have room for
85 ;; on your local disk.
87 ;; I don't know about recent features in gnu tar, but old versions of tar
88 ;; can't replace a file in the middle of a tar file with a new version.
89 ;; Tar-mode can. I don't think tar can do things like chmod the subfiles.
90 ;; An implementation which involved unpacking and repacking the file into
91 ;; some scratch directory would be very wasteful, and wouldn't be able to
92 ;; preserve the file owners.
96 (defvar tar-anal-blocksize
20
97 "*The blocksize of tar files written by Emacs, or nil, meaning don't care.
98 The blocksize of a tar file is not really the size of the blocks; rather, it is
99 the number of blocks written with one system call. When tarring to a tape,
100 this is the size of the *tape* blocks, but when writing to a file, it doesn't
101 matter much. The only noticeable difference is that if a tar file does not
102 have a blocksize of 20, tar will tell you that; all this really controls is
103 how many null padding bytes go on the end of the tar file.")
105 (defvar tar-update-datestamp nil
106 "*Non-nil means tar-mode should play fast and loose with sub-file datestamps.
107 If this is true, then editing and saving a tar file entry back into its
108 tar file will update its datestamp. If false, the datestamp is unchanged.
109 You may or may not want this - it is good in that you can tell when a file
110 in a tar archive has been changed, but it is bad for the same reason that
111 editing a file in the tar archive at all is bad - the changed version of
112 the file never exists on disk.")
114 (defvar tar-mode-show-date nil
115 "*Non-nil means Tar mode should show the date/time of each subfile.
116 This information is useful, but it takes screen space away from file names.")
118 (defvar tar-parse-info nil
)
119 (defvar tar-header-offset nil
)
120 (defvar tar-superior-buffer nil
)
121 (defvar tar-superior-descriptor nil
)
122 (defvar tar-subfile-mode nil
)
124 (put 'tar-parse-info
'permanent-local t
)
125 (put 'tar-header-offset
'permanent-local t
)
126 (put 'tar-superior-buffer
'permanent-local t
)
127 (put 'tar-superior-descriptor
'permanent-local t
)
129 ;;; First, duplicate some Common Lisp functions; I used to just (require 'cl)
130 ;;; but "cl.el" was messing some people up (also it's really big).
132 (defmacro tar-setf
(form val
)
133 "A mind-numbingly simple implementation of setf."
134 (let ((mform (macroexpand form
(and (boundp 'byte-compile-macro-environment
)
135 byte-compile-macro-environment
))))
136 (cond ((symbolp mform
) (list 'setq mform val
))
137 ((not (consp mform
)) (error "can't setf %s" form
))
138 ((eq (car mform
) 'aref
)
139 (list 'aset
(nth 1 mform
) (nth 2 mform
) val
))
140 ((eq (car mform
) 'car
)
141 (list 'setcar
(nth 1 mform
) val
))
142 ((eq (car mform
) 'cdr
)
143 (list 'setcdr
(nth 1 mform
) val
))
144 (t (error "don't know how to setf %s" form
)))))
146 (defmacro tar-dolist
(control &rest body
)
147 "syntax: (dolist (var-name list-expr &optional return-value) &body body)"
148 (let ((var (car control
))
149 (init (car (cdr control
)))
150 (val (car (cdr (cdr control
)))))
151 (list 'let
(list (list '_dolist_iterator_ init
))
152 (list 'while
'_dolist_iterator_
154 (cons (list (list var
'(car _dolist_iterator_
)))
156 (list (list 'setq
'_dolist_iterator_
157 (list 'cdr
'_dolist_iterator_
)))))))
160 (defmacro tar-dotimes
(control &rest body
)
161 "syntax: (dolist (var-name count-expr &optional return-value) &body body)"
162 (let ((var (car control
))
163 (n (car (cdr control
)))
164 (val (car (cdr (cdr control
)))))
165 (list 'let
(list (list '_dotimes_end_ n
)
168 (cons (list '< var
'_dotimes_end_
)
170 (list (list 'setq var
(list '1+ var
))))))
174 ;;; down to business.
176 (defmacro make-tar-header
(name mode uid git size date ck lt ln
177 magic uname gname devmaj devmin
)
178 (list 'vector name mode uid git size date ck lt ln
179 magic uname gname devmaj devmin
))
181 (defmacro tar-header-name
(x) (list 'aref x
0))
182 (defmacro tar-header-mode
(x) (list 'aref x
1))
183 (defmacro tar-header-uid
(x) (list 'aref x
2))
184 (defmacro tar-header-gid
(x) (list 'aref x
3))
185 (defmacro tar-header-size
(x) (list 'aref x
4))
186 (defmacro tar-header-date
(x) (list 'aref x
5))
187 (defmacro tar-header-checksum
(x) (list 'aref x
6))
188 (defmacro tar-header-link-type
(x) (list 'aref x
7))
189 (defmacro tar-header-link-name
(x) (list 'aref x
8))
190 (defmacro tar-header-magic
(x) (list 'aref x
9))
191 (defmacro tar-header-uname
(x) (list 'aref x
10))
192 (defmacro tar-header-gname
(x) (list 'aref x
11))
193 (defmacro tar-header-dmaj
(x) (list 'aref x
12))
194 (defmacro tar-header-dmin
(x) (list 'aref x
13))
196 (defmacro make-tar-desc
(data-start tokens
)
197 (list 'cons data-start tokens
))
199 (defmacro tar-desc-data-start
(x) (list 'car x
))
200 (defmacro tar-desc-tokens
(x) (list 'cdr x
))
202 (defconst tar-name-offset
0)
203 (defconst tar-mode-offset
(+ tar-name-offset
100))
204 (defconst tar-uid-offset
(+ tar-mode-offset
8))
205 (defconst tar-gid-offset
(+ tar-uid-offset
8))
206 (defconst tar-size-offset
(+ tar-gid-offset
8))
207 (defconst tar-time-offset
(+ tar-size-offset
12))
208 (defconst tar-chk-offset
(+ tar-time-offset
12))
209 (defconst tar-linkp-offset
(+ tar-chk-offset
8))
210 (defconst tar-link-offset
(+ tar-linkp-offset
1))
211 ;;; GNU-tar specific slots.
212 (defconst tar-magic-offset
(+ tar-link-offset
100))
213 (defconst tar-uname-offset
(+ tar-magic-offset
8))
214 (defconst tar-gname-offset
(+ tar-uname-offset
32))
215 (defconst tar-dmaj-offset
(+ tar-gname-offset
32))
216 (defconst tar-dmin-offset
(+ tar-dmaj-offset
8))
217 (defconst tar-end-offset
(+ tar-dmin-offset
8))
219 (defun tar-header-block-tokenize (string)
220 "Return a `tar-header' structure.
221 This is a list of name, mode, uid, gid, size,
222 write-date, checksum, link-type, and link-name."
223 (cond ((< (length string
) 512) nil
)
224 (;(some 'plusp string) ; <-- oops, massive cycle hog!
225 (or (not (= 0 (aref string
0))) ; This will do.
226 (not (= 0 (aref string
101))))
227 (let* ((name-end (1- tar-mode-offset
))
228 (link-end (1- tar-magic-offset
))
229 (uname-end (1- tar-gname-offset
))
230 (gname-end (1- tar-dmaj-offset
))
231 (link-p (aref string tar-linkp-offset
))
232 (magic-str (substring string tar-magic-offset
(1- tar-uname-offset
)))
233 (uname-valid-p (or (string= "ustar " magic-str
) (string= "GNUtar " magic-str
)))
235 (nulsexp "[^\000]*\000"))
236 (and (string-match nulsexp string tar-name-offset
) (setq name-end
(min name-end
(1- (match-end 0)))))
237 (and (string-match nulsexp string tar-link-offset
) (setq link-end
(min link-end
(1- (match-end 0)))))
238 (and (string-match nulsexp string tar-uname-offset
) (setq uname-end
(min uname-end
(1- (match-end 0)))))
239 (and (string-match nulsexp string tar-gname-offset
) (setq gname-end
(min gname-end
(1- (match-end 0)))))
240 (setq name
(substring string tar-name-offset name-end
)
241 link-p
(if (or (= link-p
0) (= link-p ?
0))
244 (if (and (null link-p
) (string-match "/$" name
)) (setq link-p
5)) ; directory
247 (tar-parse-octal-integer string tar-mode-offset
(1- tar-uid-offset
))
248 (tar-parse-octal-integer string tar-uid-offset
(1- tar-gid-offset
))
249 (tar-parse-octal-integer string tar-gid-offset
(1- tar-size-offset
))
250 (tar-parse-octal-integer string tar-size-offset
(1- tar-time-offset
))
251 (tar-parse-octal-long-integer string tar-time-offset
(1- tar-chk-offset
))
252 (tar-parse-octal-integer string tar-chk-offset
(1- tar-linkp-offset
))
254 (substring string tar-link-offset link-end
)
256 (and uname-valid-p
(substring string tar-uname-offset uname-end
))
257 (and uname-valid-p
(substring string tar-gname-offset gname-end
))
258 (tar-parse-octal-integer string tar-dmaj-offset
(1- tar-dmin-offset
))
259 (tar-parse-octal-integer string tar-dmin-offset
(1- tar-end-offset
))
261 (t 'empty-tar-block
)))
264 (defun tar-parse-octal-integer (string &optional start end
)
265 (if (null start
) (setq start
0))
266 (if (null end
) (setq end
(length string
)))
267 (if (= (aref string start
) 0)
271 (setq n
(if (< (aref string start
) ?
0) n
272 (+ (* n
8) (- (aref string start
) ?
0)))
276 (defun tar-parse-octal-long-integer (string &optional start end
)
277 (if (null start
) (setq start
0))
278 (if (null end
) (setq end
(length string
)))
279 (if (= (aref string start
) 0)
284 (if (>= (aref string start
) ?
0)
285 (setq lo
(+ (* lo
8) (- (aref string start
) ?
0))
286 hi
(+ (* hi
8) (ash lo -
16))
287 lo
(logand lo
65535)))
288 (setq start
(1+ start
)))
291 (defun tar-parse-octal-integer-safe (string)
292 (let ((L (length string
)))
293 (if (= L
0) (error "empty string"))
295 (if (or (< (aref string i
) ?
0)
296 (> (aref string i
) ?
7))
297 (error "'%c' is not an octal digit"))))
298 (tar-parse-octal-integer string
))
301 (defun tar-header-block-checksum (string)
302 "Compute and return a tar-acceptable checksum for this block."
303 (let* ((chk-field-start tar-chk-offset
)
304 (chk-field-end (+ chk-field-start
8))
307 ;; Add up all of the characters except the ones in the checksum field.
308 ;; Add that field as if it were filled with spaces.
309 (while (< i chk-field-start
)
310 (setq sum
(+ sum
(aref string i
))
312 (setq i chk-field-end
)
314 (setq sum
(+ sum
(aref string i
))
318 (defun tar-header-block-check-checksum (hblock desired-checksum file-name
)
319 "Beep and print a warning if the checksum doesn't match."
320 (if (not (= desired-checksum
(tar-header-block-checksum hblock
)))
321 (progn (beep) (message "Invalid checksum for file %s!" file-name
))))
323 (defun tar-header-block-recompute-checksum (hblock)
324 "Modifies the given string to have a valid checksum field."
325 (let* ((chk (tar-header-block-checksum hblock
))
326 (chk-string (format "%6o" chk
))
327 (l (length chk-string
)))
330 (tar-dotimes (i l
) (aset hblock
(- 153 i
) (aref chk-string
(- l i
1)))))
333 (defun tar-clip-time-string (time)
334 (let ((str (current-time-string time
)))
335 (concat (substring str
4 16) (substring str
19 24))))
337 (defun tar-grind-file-mode (mode string start
)
338 "Store `-rw--r--r--' indicating MODE into STRING beginning at START.
339 MODE should be an integer which is a file mode value."
340 (aset string start
(if (zerop (logand 256 mode
)) ?- ?r
))
341 (aset string
(+ start
1) (if (zerop (logand 128 mode
)) ?- ?w
))
342 (aset string
(+ start
2) (if (zerop (logand 64 mode
)) ?- ?x
))
343 (aset string
(+ start
3) (if (zerop (logand 32 mode
)) ?- ?r
))
344 (aset string
(+ start
4) (if (zerop (logand 16 mode
)) ?- ?w
))
345 (aset string
(+ start
5) (if (zerop (logand 8 mode
)) ?- ?x
))
346 (aset string
(+ start
6) (if (zerop (logand 4 mode
)) ?- ?r
))
347 (aset string
(+ start
7) (if (zerop (logand 2 mode
)) ?- ?w
))
348 (aset string
(+ start
8) (if (zerop (logand 1 mode
)) ?- ?x
))
349 (if (zerop (logand 1024 mode
)) nil
(aset string
(+ start
2) ?s
))
350 (if (zerop (logand 2048 mode
)) nil
(aset string
(+ start
5) ?s
))
353 (defun tar-header-block-summarize (tar-hblock &optional mod-p
)
354 "Returns a line similar to the output of `tar -vtf'."
355 (let ((name (tar-header-name tar-hblock
))
356 (mode (tar-header-mode tar-hblock
))
357 (uid (tar-header-uid tar-hblock
))
358 (gid (tar-header-gid tar-hblock
))
359 (uname (tar-header-uname tar-hblock
))
360 (gname (tar-header-gname tar-hblock
))
361 (size (tar-header-size tar-hblock
))
362 (time (tar-header-date tar-hblock
))
363 (ck (tar-header-checksum tar-hblock
))
364 (link-p (tar-header-link-type tar-hblock
))
365 (link-name (tar-header-link-name tar-hblock
))
371 (datew (if tar-mode-show-date
18 0))
372 (slash (1- (+ left namew
)))
373 (lastdigit (+ slash groupw sizew
))
374 (datestart (+ lastdigit
2))
375 (namestart (+ datestart datew
))
376 (string (make-string (+ namestart
(length name
) (if link-p
(+ 5 (length link-name
)) 0)) 32))
377 (type (tar-header-link-type tar-hblock
)))
378 (aset string
0 (if mod-p ?
* ?
))
380 (cond ((or (eq type nil
) (eq type
0)) ?-
)
381 ((eq type
1) ?l
) ; link
382 ((eq type
2) ?s
) ; symlink
383 ((eq type
3) ?c
) ; char special
384 ((eq type
4) ?b
) ; block special
385 ((eq type
5) ?d
) ; directory
386 ((eq type
6) ?p
) ; FIFO/pipe
387 ((eq type
20) ?
*) ; directory listing
388 ((eq type
29) ?M
) ; multivolume continuation
389 ((eq type
35) ?S
) ; sparse
390 ((eq type
38) ?V
) ; volume header
392 (tar-grind-file-mode mode string
2)
393 (setq uid
(if (= 0 (length uname
)) (int-to-string uid
) uname
))
394 (setq gid
(if (= 0 (length gname
)) (int-to-string gid
) gname
))
395 (setq size
(int-to-string size
))
396 (setq time
(tar-clip-time-string time
))
397 (tar-dotimes (i (min (1- namew
) (length uid
))) (aset string
(- slash i
) (aref uid
(- (length uid
) i
1))))
398 (aset string
(1+ slash
) ?
/)
399 (tar-dotimes (i (min (1- groupw
) (length gid
))) (aset string
(+ (+ slash
2) i
) (aref gid i
)))
400 (tar-dotimes (i (min sizew
(length size
))) (aset string
(- lastdigit i
) (aref size
(- (length size
) i
1))))
401 (if tar-mode-show-date
402 (tar-dotimes (i (length time
)) (aset string
(+ datestart i
) (aref time i
))))
403 (tar-dotimes (i (length name
)) (aset string
(+ namestart i
) (aref name i
)))
404 (if (or (eq link-p
1) (eq link-p
2))
406 (tar-dotimes (i 3) (aset string
(+ namestart
1 (length name
) i
) (aref (if (= link-p
1) "==>" "-->") i
)))
407 (tar-dotimes (i (length link-name
)) (aset string
(+ namestart
5 (length name
) i
) (aref link-name i
)))))
408 (put-text-property namestart
(length string
)
409 'mouse-face
'highlight string
)
413 (defun tar-summarize-buffer ()
414 "Parse the contents of the tar file in the current buffer.
415 Place a dired-like listing on the front;
416 then narrow to it, so that only that listing
417 is visible (and the real data of the buffer is hidden)."
418 (message "Parsing tar file...")
421 (bs (max 1 (- (buffer-size) 1024))) ; always 2+ empty blocks at end.
422 (bs100 (max 1 (/ bs
100)))
424 (while (and (<= (+ pos
512) (point-max))
425 (not (eq 'empty-tar-block
427 (tar-header-block-tokenize
428 (buffer-substring pos
(+ pos
512)))))))
429 (setq pos
(+ pos
512))
430 (message "Parsing tar file...%d%%"
431 ;(/ (* pos 100) bs) ; this gets round-off lossage
432 (/ pos bs100
) ; this doesn't
434 (if (eq (tar-header-link-type tokens
) 20)
435 ;; Foo. There's an extra empty block after these.
436 (setq pos
(+ pos
512)))
437 (let ((size (tar-header-size tokens
)))
439 (error "%s has size %s - corrupted"
440 (tar-header-name tokens
) size
))
442 ; This is just too slow. Don't really need it anyway....
443 ;(tar-header-block-check-checksum
444 ; hblock (tar-header-block-checksum hblock)
445 ; (tar-header-name tokens))
447 (setq result
(cons (make-tar-desc pos tokens
) result
))
449 (and (null (tar-header-link-type tokens
))
452 (+ pos
512 (ash (ash (1- size
) -
9) 9)) ; this works
453 ;(+ pos (+ size (- 512 (rem (1- size) 512)))) ; this doesn't
455 (make-local-variable 'tar-parse-info
)
456 (setq tar-parse-info
(nreverse result
))
457 ;; A tar file should end with a block or two of nulls,
458 ;; but let's not get a fatal error if it doesn't.
459 (if (eq tokens
'empty-tar-block
)
460 (message "Parsing tar file...done")
461 (message "Warning: premature EOF parsing tar file")))
463 (goto-char (point-min))
464 (let ((buffer-read-only nil
)
466 ;; Collect summary lines and insert them all at once since tar files
467 ;; can be pretty big.
468 (tar-dolist (tar-desc (reverse tar-parse-info
))
470 (cons (tar-header-block-summarize (tar-desc-tokens tar-desc
))
473 (insert (apply 'concat summaries
))
474 (make-local-variable 'tar-header-offset
)
475 (setq tar-header-offset
(point))
476 (narrow-to-region 1 tar-header-offset
)
477 (set-buffer-modified-p nil
))))
479 (defvar tar-mode-map nil
"*Local keymap for Tar mode listings.")
483 (setq tar-mode-map
(make-keymap))
484 (suppress-keymap tar-mode-map
)
485 (define-key tar-mode-map
" " 'tar-next-line
)
486 (define-key tar-mode-map
"c" 'tar-copy
)
487 (define-key tar-mode-map
"d" 'tar-flag-deleted
)
488 (define-key tar-mode-map
"\^D" 'tar-flag-deleted
)
489 (define-key tar-mode-map
"e" 'tar-extract
)
490 (define-key tar-mode-map
"f" 'tar-extract
)
491 (define-key tar-mode-map
"\C-m" 'tar-extract
)
492 (define-key tar-mode-map
[mouse-2
] 'tar-mouse-extract
)
493 (define-key tar-mode-map
"g" 'revert-buffer
)
494 (define-key tar-mode-map
"h" 'describe-mode
)
495 (define-key tar-mode-map
"n" 'tar-next-line
)
496 (define-key tar-mode-map
"\^N" 'tar-next-line
)
497 (define-key tar-mode-map
"o" 'tar-extract-other-window
)
498 (define-key tar-mode-map
"p" 'tar-previous-line
)
499 (define-key tar-mode-map
"\^P" 'tar-previous-line
)
500 (define-key tar-mode-map
"r" 'tar-rename-entry
)
501 (define-key tar-mode-map
"u" 'tar-unflag
)
502 (define-key tar-mode-map
"v" 'tar-view
)
503 (define-key tar-mode-map
"x" 'tar-expunge
)
504 (define-key tar-mode-map
"\177" 'tar-unflag-backwards
)
505 (define-key tar-mode-map
"E" 'tar-extract-other-window
)
506 (define-key tar-mode-map
"M" 'tar-chmod-entry
)
507 (define-key tar-mode-map
"G" 'tar-chgrp-entry
)
508 (define-key tar-mode-map
"O" 'tar-chown-entry
)
511 ;; Make menu bar items.
513 ;; Get rid of the Edit menu bar item to save space.
514 (define-key tar-mode-map
[menu-bar edit
] 'undefined
)
516 (define-key tar-mode-map
[menu-bar immediate
]
517 (cons "Immediate" (make-sparse-keymap "Immediate")))
519 (define-key tar-mode-map
[menu-bar immediate view
]
520 '("View This File" . tar-view
))
521 (define-key tar-mode-map
[menu-bar immediate display
]
522 '("Display in Other Window" . tar-display-other-file
))
523 (define-key tar-mode-map
[menu-bar immediate find-file-other-window
]
524 '("Find in Other Window" . tar-extract-other-window
))
525 (define-key tar-mode-map
[menu-bar immediate find-file
]
526 '("Find This File" . tar-extract
))
528 (define-key tar-mode-map
[menu-bar mark
]
529 (cons "Mark" (make-sparse-keymap "Mark")))
531 (define-key tar-mode-map
[menu-bar mark unmark-all
]
532 '("Unmark All" . tar-clear-modification-flags
))
533 (define-key tar-mode-map
[menu-bar mark deletion
]
534 '("Flag" . tar-flag-deleted
))
535 (define-key tar-mode-map
[menu-bar mark unmark
]
536 '("Unflag" . tar-unflag
))
538 (define-key tar-mode-map
[menu-bar operate
]
539 (cons "Operate" (make-sparse-keymap "Operate")))
541 (define-key tar-mode-map
[menu-bar operate chown
]
542 '("Change Owner..." . tar-chown-entry
))
543 (define-key tar-mode-map
[menu-bar operate chgrp
]
544 '("Change Group..." . tar-chgrp-entry
))
545 (define-key tar-mode-map
[menu-bar operate chmod
]
546 '("Change Mode..." . tar-chmod-entry
))
547 (define-key tar-mode-map
[menu-bar operate rename
]
548 '("Rename to..." . tar-rename-entry
))
549 (define-key tar-mode-map
[menu-bar operate copy
]
550 '("Copy to..." . tar-copy
))
551 (define-key tar-mode-map
[menu-bar operate expunge
]
552 '("Expunge Marked Files" . tar-expunge
))
554 ;; tar mode is suitable only for specially formatted data.
555 (put 'tar-mode
'mode-class
'special
)
556 (put 'tar-subfile-mode
'mode-class
'special
)
560 "Major mode for viewing a tar file as a dired-like listing of its contents.
561 You can move around using the usual cursor motion commands.
562 Letters no longer insert themselves.
563 Type `e' to pull a file out of the tar file and into its own buffer;
564 or click mouse-2 on the file's line in the Tar mode buffer.
565 Type `c' to copy an entry from the tar file into another file on disk.
567 If you edit a sub-file of this archive (as with the `e' command) and
568 save it with Control-x Control-s, the contents of that buffer will be
569 saved back into the tar-file buffer; in this way you can edit a file
570 inside of a tar archive without extracting it and re-archiving it.
572 See also: variables `tar-update-datestamp' and `tar-anal-blocksize'.
574 ;; this is not interactive because you shouldn't be turning this
575 ;; mode on and off. You can corrupt things that way.
576 ;; rms: with permanent locals, it should now be possible to make this work
577 ;; interactively in some reasonable fashion.
578 (kill-all-local-variables)
579 (make-local-variable 'tar-header-offset
)
580 (make-local-variable 'tar-parse-info
)
581 (make-local-variable 'require-final-newline
)
582 (setq require-final-newline nil
) ; binary data, dude...
583 (make-local-variable 'revert-buffer-function
)
584 (setq revert-buffer-function
'tar-mode-revert
)
585 (make-local-variable 'enable-local-variables
)
586 (setq enable-local-variables nil
)
587 (make-local-variable 'next-line-add-newlines
)
588 (setq next-line-add-newlines nil
)
589 (setq major-mode
'tar-mode
)
590 (setq mode-name
"Tar")
591 (use-local-map tar-mode-map
)
593 (make-local-variable 'write-contents-hooks
)
594 (setq write-contents-hooks
'(tar-mode-write-file))
596 (if (and (boundp 'tar-header-offset
) tar-header-offset
)
597 (narrow-to-region 1 tar-header-offset
)
598 (tar-summarize-buffer))
599 (run-hooks 'tar-mode-hook
)
603 (defun tar-subfile-mode (p)
604 "Minor mode for editing an element of a tar-file.
605 This mode arranges for \"saving\" this buffer to write the data
606 into the tar-file buffer that it came from. The changes will actually
607 appear on disk when you save the tar-file's buffer."
609 (or (and (boundp 'tar-superior-buffer
) tar-superior-buffer
)
610 (error "This buffer is not an element of a tar file"))
611 ;;; Don't do this, because it is redundant and wastes mode line space.
612 ;;; (or (assq 'tar-subfile-mode minor-mode-alist)
613 ;;; (setq minor-mode-alist (append minor-mode-alist
614 ;;; (list '(tar-subfile-mode " TarFile")))))
615 (make-local-variable 'tar-subfile-mode
)
616 (setq tar-subfile-mode
618 (not tar-subfile-mode
)
619 (> (prefix-numeric-value p
) 0)))
620 (cond (tar-subfile-mode
621 (make-local-variable 'local-write-file-hooks
)
622 (setq local-write-file-hooks
'(tar-subfile-save-buffer))
623 ;; turn off auto-save.
625 (setq buffer-auto-save-file-name nil
)
626 (run-hooks 'tar-subfile-mode-hook
))
628 (kill-local-variable 'local-write-file-hooks
))))
631 ;; Revert the buffer and recompute the dired-like listing.
632 (defun tar-mode-revert (&optional no-autosave no-confirm
)
633 (let ((revert-buffer-function nil
)
634 (old-offset tar-header-offset
)
636 (setq tar-header-offset nil
)
638 (and (revert-buffer t no-confirm
)
642 ;; If the revert was canceled,
643 ;; put back the old value of tar-header-offset.
645 (setq tar-header-offset old-offset
)))))
648 (defun tar-next-line (p)
651 (if (eobp) nil
(forward-char (if tar-mode-show-date
54 36))))
653 (defun tar-previous-line (p)
655 (tar-next-line (- p
)))
657 (defun tar-current-descriptor (&optional noerror
)
658 "Return the tar-descriptor of the current line, or signals an error."
659 ;; I wish lines had plists, like in ZMACS...
660 (or (nth (count-lines (point-min)
661 (save-excursion (beginning-of-line) (point)))
665 (error "This line does not describe a tar-file entry"))))
667 (defun tar-get-descriptor ()
668 (let* ((descriptor (tar-current-descriptor))
669 (tokens (tar-desc-tokens descriptor
))
670 (size (tar-header-size tokens
))
671 (link-p (tar-header-link-type tokens
)))
673 (error "This is a %s, not a real file"
674 (cond ((eq link-p
5) "directory")
675 ((eq link-p
20) "tar directory header")
676 ((eq link-p
29) "multivolume-continuation")
677 ((eq link-p
35) "sparse entry")
678 ((eq link-p
38) "volume header")
680 (if (zerop size
) (error "This is a zero-length file"))
683 (defun tar-mouse-extract (event)
684 "Extract a file whose tar directory line you click on."
687 (set-buffer (window-buffer (posn-window (event-end event
))))
689 (goto-char (posn-point (event-end event
)))
690 ;; Just make sure this doesn't get an error.
691 (tar-get-descriptor)))
692 (select-window (posn-window (event-end event
)))
693 (goto-char (posn-point (event-end event
)))
696 (defun tar-extract (&optional other-window-p
)
697 "In Tar mode, extract this entry of the tar file into its own buffer."
699 (let* ((view-p (eq other-window-p
'view
))
700 (descriptor (tar-get-descriptor))
701 (tokens (tar-desc-tokens descriptor
))
702 (name (tar-header-name tokens
))
703 (size (tar-header-size tokens
))
704 (start (+ (tar-desc-data-start descriptor
) tar-header-offset -
1))
705 (end (+ start size
)))
706 (let* ((tar-buffer (current-buffer))
707 (tarname (file-name-nondirectory (buffer-file-name)))
708 (bufname (concat (file-name-nondirectory name
)
712 (read-only-p (or buffer-read-only view-p
))
713 (buffer (get-buffer bufname
))
717 (setq buffer
(get-buffer-create bufname
))
718 (setq just-created t
)
724 (insert-buffer-substring tar-buffer start end
)
726 (setq buffer-file-name
727 (expand-file-name (concat tarname
":" name
)))
728 (setq buffer-file-truename
729 (abbreviate-file-name buffer-file-name
))
730 ;; Set the default-directory to the dir of the
732 (setq default-directory
734 (set-buffer tar-buffer
)
736 (normal-mode) ; pick a mode.
737 (rename-buffer bufname
)
738 (make-local-variable 'tar-superior-buffer
)
739 (make-local-variable 'tar-superior-descriptor
)
740 (setq tar-superior-buffer tar-buffer
)
741 (setq tar-superior-descriptor descriptor
)
742 (setq buffer-read-only read-only-p
)
743 (set-buffer-modified-p nil
)
744 (tar-subfile-mode 1))
745 (set-buffer tar-buffer
))
746 (narrow-to-region 1 tar-header-offset
)))
751 ;; This will be created by view.el
752 (setq view-exit-action
'kill-buffer
)))
753 (if (eq other-window-p
'display
)
754 (display-buffer buffer
)
756 (switch-to-buffer-other-window buffer
)
757 (switch-to-buffer buffer
)))))))
760 (defun tar-extract-other-window ()
761 "*In Tar mode, find this entry of the tar file in another window."
765 (defun tar-display-other-window ()
766 "*In Tar mode, display this entry of the tar file in another window."
768 (tar-extract 'display
))
771 "*In Tar mode, view the tar file entry on this line."
776 (defun tar-read-file-name (&optional prompt
)
777 "Read a file name with this line's entry as the default."
778 (or prompt
(setq prompt
"Copy to: "))
779 (let* ((default-file (expand-file-name
780 (tar-header-name (tar-desc-tokens
781 (tar-current-descriptor)))))
782 (target (expand-file-name
783 (read-file-name prompt
784 (file-name-directory default-file
)
786 (if (or (string= "" (file-name-nondirectory target
))
787 (file-directory-p target
))
788 (setq target
(concat (if (string-match "/$" target
)
789 (substring target
0 (1- (match-end 0)))
792 (file-name-nondirectory default-file
))))
796 (defun tar-copy (&optional to-file
)
797 "*In Tar mode, extract this entry of the tar file into a file on disk.
798 If TO-FILE is not supplied, it is prompted for, defaulting to the name of
799 the current tar-entry."
800 (interactive (list (tar-read-file-name)))
801 (let* ((descriptor (tar-get-descriptor))
802 (tokens (tar-desc-tokens descriptor
))
803 (name (tar-header-name tokens
))
804 (size (tar-header-size tokens
))
805 (start (+ (tar-desc-data-start descriptor
) tar-header-offset -
1))
807 (inhibit-file-name-handlers inhibit-file-name-handlers
)
808 (inhibit-file-name-operation inhibit-file-name-operation
))
811 ;; Inhibit compressing a subfile again if *both* name and
812 ;; to-file are handled by jka-compr
813 (if (and (eq (find-file-name-handler name
'write-region
) 'jka-compr-handler
)
814 (eq (find-file-name-handler to-file
'write-region
) 'jka-compr-handler
))
815 (setq inhibit-file-name-handlers
816 (cons 'jka-compr-handler
817 (and (eq inhibit-file-name-operation
'write-region
)
818 inhibit-file-name-handlers
))
819 inhibit-file-name-operation
'write-region
))
820 (write-region start end to-file
))
821 (message "Copied tar entry %s to %s" name to-file
)))
823 (defun tar-flag-deleted (p &optional unflag
)
824 "*In Tar mode, mark this sub-file to be deleted from the tar file.
825 With a prefix argument, mark that many files."
828 (tar-dotimes (i (if (< p
0) (- p
) p
))
829 (if (tar-current-descriptor unflag
) ; barf if we're not on an entry-line.
832 (insert (if unflag
" " "D"))))
833 (forward-line (if (< p
0) -
1 1)))
834 (if (eobp) nil
(forward-char 36)))
836 (defun tar-unflag (p)
837 "*In Tar mode, un-mark this sub-file if it is marked to be deleted.
838 With a prefix argument, un-mark that many files forward."
840 (tar-flag-deleted p t
))
842 (defun tar-unflag-backwards (p)
843 "*In Tar mode, un-mark this sub-file if it is marked to be deleted.
844 With a prefix argument, un-mark that many files backward."
846 (tar-flag-deleted (- p
) t
))
849 (defun tar-expunge-internal ()
850 "Expunge the tar-entry specified by the current line."
851 (let* ((descriptor (tar-current-descriptor))
852 (tokens (tar-desc-tokens descriptor
))
853 (line (tar-desc-data-start descriptor
))
854 (name (tar-header-name tokens
))
855 (size (tar-header-size tokens
))
856 (link-p (tar-header-link-type tokens
))
857 (start (tar-desc-data-start descriptor
))
858 (following-descs (cdr (memq descriptor tar-parse-info
))))
859 (if link-p
(setq size
0)) ; size lies for hard-links.
861 ;; delete the current line...
863 (let ((line-start (point)))
864 (end-of-line) (forward-char)
865 (let ((line-len (- (point) line-start
)))
866 (delete-region line-start
(point))
868 ;; decrement the header-pointer to be in sync...
869 (setq tar-header-offset
(- tar-header-offset line-len
))))
871 ;; delete the data pointer...
872 (setq tar-parse-info
(delq descriptor tar-parse-info
))
874 ;; delete the data from inside the file...
876 (let* ((data-start (+ start tar-header-offset -
513))
877 (data-end (+ data-start
512 (ash (ash (+ size
511) -
9) 9))))
878 (delete-region data-start data-end
)
880 ;; and finally, decrement the start-pointers of all following
881 ;; entries in the archive. This is a pig when deleting a bunch
882 ;; of files at once - we could optimize this to only do the
883 ;; iteration over the files that remain, or only iterate up to
884 ;; the next file to be deleted.
885 (let ((data-length (- data-end data-start
)))
886 (tar-dolist (desc following-descs
)
887 (tar-setf (tar-desc-data-start desc
)
888 (- (tar-desc-data-start desc
) data-length
))))
890 (narrow-to-region 1 tar-header-offset
))
893 (defun tar-expunge (&optional noconfirm
)
894 "*In Tar mode, delete all the archived files flagged for deletion.
895 This does not modify the disk image; you must save the tar file itself
896 for this to be permanent."
899 (y-or-n-p "Expunge files marked for deletion? "))
905 (progn (tar-expunge-internal)
908 ;; after doing the deletions, add any padding that may be necessary.
909 (tar-pad-to-blocksize)
910 (narrow-to-region 1 tar-header-offset
)
913 (message "Nothing to expunge.")
914 (message "%s files expunged. Be sure to save this buffer." n
)))))
917 (defun tar-clear-modification-flags ()
918 "Remove the stars at the beginning of each line."
922 (while (< (point) tar-header-offset
)
923 (if (not (eq (following-char) ?\
))
924 (progn (delete-char 1) (insert " ")))
928 (defun tar-chown-entry (new-uid)
929 "*Change the user-id associated with this entry in the tar file.
930 If this tar file was written by GNU tar, then you will be able to edit
931 the user id as a string; otherwise, you must edit it as a number.
932 You can force editing as a number by calling this with a prefix arg.
933 This does not modify the disk image; you must save the tar file itself
934 for this to be permanent."
936 (let ((tokens (tar-desc-tokens (tar-current-descriptor))))
937 (if (or current-prefix-arg
938 (not (tar-header-magic tokens
)))
940 (while (not (numberp (setq n
(read-minibuffer
942 (format "%s" (tar-header-uid tokens
)))))))
944 (read-string "New UID string: " (tar-header-uname tokens
))))))
945 (cond ((stringp new-uid
)
946 (tar-setf (tar-header-uname (tar-desc-tokens (tar-current-descriptor)))
948 (tar-alter-one-field tar-uname-offset
(concat new-uid
"\000")))
950 (tar-setf (tar-header-uid (tar-desc-tokens (tar-current-descriptor)))
952 (tar-alter-one-field tar-uid-offset
953 (concat (substring (format "%6o" new-uid
) 0 6) "\000 ")))))
956 (defun tar-chgrp-entry (new-gid)
957 "*Change the group-id associated with this entry in the tar file.
958 If this tar file was written by GNU tar, then you will be able to edit
959 the group id as a string; otherwise, you must edit it as a number.
960 You can force editing as a number by calling this with a prefix arg.
961 This does not modify the disk image; you must save the tar file itself
962 for this to be permanent."
964 (let ((tokens (tar-desc-tokens (tar-current-descriptor))))
965 (if (or current-prefix-arg
966 (not (tar-header-magic tokens
)))
968 (while (not (numberp (setq n
(read-minibuffer
970 (format "%s" (tar-header-gid tokens
)))))))
972 (read-string "New GID string: " (tar-header-gname tokens
))))))
973 (cond ((stringp new-gid
)
974 (tar-setf (tar-header-gname (tar-desc-tokens (tar-current-descriptor)))
976 (tar-alter-one-field tar-gname-offset
977 (concat new-gid
"\000")))
979 (tar-setf (tar-header-gid (tar-desc-tokens (tar-current-descriptor)))
981 (tar-alter-one-field tar-gid-offset
982 (concat (substring (format "%6o" new-gid
) 0 6) "\000 ")))))
984 (defun tar-rename-entry (new-name)
985 "*Change the name associated with this entry in the tar file.
986 This does not modify the disk image; you must save the tar file itself
987 for this to be permanent."
989 (list (read-string "New name: "
990 (tar-header-name (tar-desc-tokens (tar-current-descriptor))))))
991 (if (string= "" new-name
) (error "zero length name"))
992 (if (> (length new-name
) 98) (error "name too long"))
993 (tar-setf (tar-header-name (tar-desc-tokens (tar-current-descriptor)))
995 (tar-alter-one-field 0
996 (substring (concat new-name
(make-string 99 0)) 0 99)))
999 (defun tar-chmod-entry (new-mode)
1000 "*Change the protection bits associated with this entry in the tar file.
1001 This does not modify the disk image; you must save the tar file itself
1002 for this to be permanent."
1003 (interactive (list (tar-parse-octal-integer-safe
1004 (read-string "New protection (octal): "))))
1005 (tar-setf (tar-header-mode (tar-desc-tokens (tar-current-descriptor)))
1007 (tar-alter-one-field tar-mode-offset
1008 (concat (substring (format "%6o" new-mode
) 0 6) "\000 ")))
1011 (defun tar-alter-one-field (data-position new-data-string
)
1012 (let* ((descriptor (tar-current-descriptor))
1013 (tokens (tar-desc-tokens descriptor
)))
1017 ;; update the header-line.
1021 (delete-region p
(point))
1022 (insert (tar-header-block-summarize tokens
) "\n")
1023 (setq tar-header-offset
(point-max)))
1026 (let* ((start (+ (tar-desc-data-start descriptor
) tar-header-offset -
513)))
1028 ;; delete the old field and insert a new one.
1029 (goto-char (+ start data-position
))
1030 (delete-region (point) (+ (point) (length new-data-string
))) ; <--
1031 (insert new-data-string
) ; <--
1033 ;; compute a new checksum and insert it.
1034 (let ((chk (tar-header-block-checksum
1035 (buffer-substring start
(+ start
512)))))
1036 (goto-char (+ start tar-chk-offset
))
1037 (delete-region (point) (+ (point) 8))
1038 (insert (format "%6o" chk
))
1041 (tar-setf (tar-header-checksum tokens
) chk
)
1043 ;; ok, make sure we didn't botch it.
1044 (tar-header-block-check-checksum
1045 (buffer-substring start
(+ start
512))
1046 chk
(tar-header-name tokens
))
1048 (narrow-to-region 1 tar-header-offset
))))
1051 (defun tar-octal-time (timeval)
1052 ;; Format a timestamp as 11 octal digits. Ghod, I hope this works...
1053 (let ((hibits (car timeval
)) (lobits (car (cdr timeval
))))
1054 (insert (format "%05o%01o%05o"
1056 (logior (lsh (logand 3 hibits
) 1) (> (logand lobits
32768) 0))
1057 (logand 32767 lobits
)
1060 (defun tar-subfile-save-buffer ()
1061 "In tar subfile mode, save this buffer into its parent tar-file buffer.
1062 This doesn't write anything to disk; you must save the parent tar-file buffer
1063 to make your changes permanent."
1065 (if (not (and (boundp 'tar-superior-buffer
) tar-superior-buffer
))
1066 (error "This buffer has no superior tar file buffer"))
1067 (if (not (and (boundp 'tar-superior-descriptor
) tar-superior-descriptor
))
1068 (error "This buffer doesn't have an index into its superior tar file!"))
1070 (let ((subfile (current-buffer))
1071 (subfile-size (buffer-size))
1072 (descriptor tar-superior-descriptor
))
1073 (set-buffer tar-superior-buffer
)
1074 (let* ((tokens (tar-desc-tokens descriptor
))
1075 (start (tar-desc-data-start descriptor
))
1076 (name (tar-header-name tokens
))
1077 (size (tar-header-size tokens
))
1078 (size-pad (ash (ash (+ size
511) -
9) 9))
1079 (head (memq descriptor tar-parse-info
))
1080 (following-descs (cdr head
)))
1082 (error "Can't find this tar file entry in its parent tar file!"))
1086 ;; delete the old data...
1087 (let* ((data-start (+ start tar-header-offset -
1))
1088 (data-end (+ data-start
(ash (ash (+ size
511) -
9) 9))))
1089 (delete-region data-start data-end
)
1090 ;; insert the new data...
1091 (goto-char data-start
)
1092 (insert-buffer subfile
)
1094 ;; pad the new data out to a multiple of 512...
1095 (let ((subfile-size-pad (ash (ash (+ subfile-size
511) -
9) 9)))
1096 (goto-char (+ data-start subfile-size
))
1097 (insert (make-string (- subfile-size-pad subfile-size
) 0))
1099 ;; update the data pointer of this and all following files...
1100 (tar-setf (tar-header-size tokens
) subfile-size
)
1101 (let ((difference (- subfile-size-pad size-pad
)))
1102 (tar-dolist (desc following-descs
)
1103 (tar-setf (tar-desc-data-start desc
)
1104 (+ (tar-desc-data-start desc
) difference
))))
1106 ;; Update the size field in the header block.
1107 (let ((header-start (- data-start
512)))
1108 (goto-char (+ header-start tar-size-offset
))
1109 (delete-region (point) (+ (point) 12))
1110 (insert (format "%11o" subfile-size
))
1113 ;; Maybe update the datestamp.
1114 (if (not tar-update-datestamp
)
1116 (goto-char (+ header-start tar-time-offset
))
1117 (delete-region (point) (+ (point) 12))
1118 (insert (tar-octal-time (current-time)))
1121 ;; compute a new checksum and insert it.
1122 (let ((chk (tar-header-block-checksum
1123 (buffer-substring header-start data-start
))))
1124 (goto-char (+ header-start tar-chk-offset
))
1125 (delete-region (point) (+ (point) 8))
1126 (insert (format "%6o" chk
))
1129 (tar-setf (tar-header-checksum tokens
) chk
)))
1131 ;; alter the descriptor-line...
1133 (let ((position (- (length tar-parse-info
) (length head
))))
1135 (next-line position
)
1139 (m (set-marker (make-marker) tar-header-offset
)))
1141 (setq after
(point))
1142 ;; Insert the new text after the old, before deleting,
1143 ;; to preserve the window start.
1144 (insert-before-markers (tar-header-block-summarize tokens t
) "\n")
1145 (delete-region p after
)
1146 (setq tar-header-offset
(marker-position m
)))
1148 ;; after doing the insertion, add any final padding that may be necessary.
1149 (tar-pad-to-blocksize))
1150 (narrow-to-region 1 tar-header-offset
)))
1151 (set-buffer-modified-p t
) ; mark the tar file as modified
1152 (set-buffer subfile
)
1153 (set-buffer-modified-p nil
) ; mark the tar subfile as unmodified
1154 (message "Saved into tar-buffer `%s'. Be sure to save that buffer!"
1155 (buffer-name tar-superior-buffer
))
1156 ;; Prevent ordinary saving from happening.
1160 (defun tar-pad-to-blocksize ()
1161 "If we are being anal about tar file blocksizes, fix up the current buffer.
1162 Leaves the region wide."
1163 (if (null tar-anal-blocksize
)
1166 (let* ((last-desc (nth (1- (length tar-parse-info
)) tar-parse-info
))
1167 (start (tar-desc-data-start last-desc
))
1168 (tokens (tar-desc-tokens last-desc
))
1169 (link-p (tar-header-link-type tokens
))
1170 (size (if link-p
0 (tar-header-size tokens
)))
1171 (data-end (+ start size
))
1172 (bbytes (ash tar-anal-blocksize
9))
1173 (pad-to (+ bbytes
(* bbytes
(/ (1- data-end
) bbytes
))))
1174 (inhibit-read-only t
) ; ##
1176 ;; If the padding after the last data is too long, delete some;
1177 ;; else insert some until we are padded out to the right number of blocks.
1179 (goto-char (+ (or tar-header-offset
0) data-end
))
1180 (if (> (1+ (buffer-size)) (+ (or tar-header-offset
0) pad-to
))
1181 (delete-region (+ (or tar-header-offset
0) pad-to
) (1+ (buffer-size)))
1182 (insert (make-string (- (+ (or tar-header-offset
0) pad-to
)
1188 ;; Used in write-file-hook to write tar-files out correctly.
1189 (defun tar-mode-write-file ()
1193 ;; Doing this here confuses things - the region gets left too wide!
1194 ;; I suppose this is run in a context where changing the buffer is bad.
1195 ;; (tar-pad-to-blocksize)
1196 (write-region tar-header-offset
(point-max) buffer-file-name nil t
)
1197 (tar-clear-modification-flags))
1198 (narrow-to-region 1 tar-header-offset
))
1199 ;; return T because we've written the file.
1204 ;;; tar-mode.el ends here
