Debian Codegraph @

upstream/fedora-44/man1/file.1

raw
1 .\" $File: file.man,v 1.151 2024/04/07 21:27:35 christos Exp $
2 .Dd April 7, 2024
3 .Dt FILE 1
4 .Os
5 .Sh NAME
6 .Nm file
7 .Nd determine file type
8 .Sh SYNOPSIS
9 .Nm
10 .Bk -words
11 .Op Fl bcdEhiklLNnprsSvzZ0
12 .Op Fl Fl apple
13 .Op Fl Fl exclude-quiet
14 .Op Fl Fl extension
15 .Op Fl Fl mime-encoding
16 .Op Fl Fl mime-type
17 .Op Fl e Ar testname
18 .Op Fl F Ar separator
19 .Op Fl f Ar namefile
20 .Op Fl m Ar magicfiles
21 .Op Fl P Ar name=value
22 .Ar
23 .Ek
24 .Nm
25 .Fl C
26 .Op Fl m Ar magicfiles
27 .Nm
28 .Op Fl Fl help
29 .Sh DESCRIPTION
30 This manual page documents version 5.46 of the
31 .Nm
32 command.
33 .Pp
34 .Nm
35 tests each argument in an attempt to classify it.
36 There are three sets of tests, performed in this order:
37 filesystem tests, magic tests, and language tests.
38 The
39 .Em first
40 test that succeeds causes the file type to be printed.
41 .Pp
42 The type printed will usually contain one of the words
43 .Em text
44 (the file contains only
45 printing characters and a few common control
46 characters and is probably safe to read on an
47 .Dv ASCII
48 terminal),
49 .Em executable
50 (the file contains the result of compiling a program
51 in a form understandable to some
52 .Tn UNIX
53 kernel or another),
54 or
55 .Em data
56 meaning anything else (data is usually
57 .Dq binary
58 or non-printable).
59 Exceptions are well-known file formats (core files, tar archives)
60 that are known to contain binary data.
61 When modifying magic files or the program itself, make sure to
62 .Em preserve these keywords .
63 Users depend on knowing that all the readable files in a directory
64 have the word
65 .Dq text
66 printed.
67 Don't do as Berkeley did and change
68 .Dq shell commands text
69 to
70 .Dq shell script .
71 .Pp
72 The filesystem tests are based on examining the return from a
73 .Xr stat 2
74 system call.
75 The program checks to see if the file is empty,
76 or if it's some sort of special file.
77 Any known file types appropriate to the system you are running on
78 (sockets, symbolic links, or named pipes (FIFOs) on those systems that
79 implement them)
80 are intuited if they are defined in the system header file
81 .In sys/stat.h .
82 .Pp
83 The magic tests are used to check for files with data in
84 particular fixed formats.
85 The canonical example of this is a binary executable (compiled program)
86 .Dv a.out
87 file, whose format is defined in
88 .In elf.h ,
89 .In a.out.h
90 and possibly
91 .In exec.h
92 in the standard include directory.
93 These files have a
94 .Dq magic number
95 stored in a particular place
96 near the beginning of the file that tells the
97 .Tn UNIX
98 operating system
99 that the file is a binary executable, and which of several types thereof.
100 The concept of a
101 .Dq magic number
102 has been applied by extension to data files.
103 Any file with some invariant identifier at a small fixed
104 offset into the file can usually be described in this way.
105 The information identifying these files is read from the compiled
106 magic file
107 .Pa /usr/share/misc/magic.mgc ,
108 or the files in the directory
109 .Pa /usr/share/misc/magic
110 if the compiled file does not exist.
111 In addition, if
112 .Pa $HOME/.magic.mgc
113 or
114 .Pa $HOME/.magic
115 exists, it will be used in preference to the system magic files.
116 .Pp
117 If a file does not match any of the entries in the magic file,
118 it is examined to see if it seems to be a text file.
119 ASCII, ISO-8859-x, non-ISO 8-bit extended-ASCII character sets
120 (such as those used on Macintosh and IBM PC systems),
121 UTF-8-encoded Unicode, UTF-16-encoded Unicode, and EBCDIC
122 character sets can be distinguished by the different
123 ranges and sequences of bytes that constitute printable text
124 in each set.
125 If a file passes any of these tests, its character set is reported.
126 ASCII, ISO-8859-x, UTF-8, and extended-ASCII files are identified
127 as
128 .Dq text
129 because they will be mostly readable on nearly any terminal;
130 UTF-16 and EBCDIC are only
131 .Dq character data
132 because, while
133 they contain text, it is text that will require translation
134 before it can be read.
135 In addition,
136 .Nm
137 will attempt to determine other characteristics of text-type files.
138 If the lines of a file are terminated by CR, CRLF, or NEL, instead
139 of the Unix-standard LF, this will be reported.
140 Files that contain embedded escape sequences or overstriking
141 will also be identified.
142 .Pp
143 Once
144 .Nm
145 has determined the character set used in a text-type file,
146 it will
147 attempt to determine in what language the file is written.
148 The language tests look for particular strings (cf.
149 .In names.h )
150 that can appear anywhere in the first few blocks of a file.
151 For example, the keyword
152 .Em .br
153 indicates that the file is most likely a
154 .Xr troff 1
155 input file, just as the keyword
156 .Em struct
157 indicates a C program.
158 These tests are less reliable than the previous
159 two groups, so they are performed last.
160 The language test routines also test for some miscellany
161 (such as
162 .Xr tar 1
163 archives, JSON files).
164 .Pp
165 Any file that cannot be identified as having been written
166 in any of the character sets listed above is simply said to be
167 .Dq data .
168 .Sh OPTIONS
169 .Bl -tag -width indent
170 .It Fl Fl apple
171 Causes the
172 .Nm
173 command to output the file type and creator code as
174 used by older MacOS versions.
175 The code consists of eight letters,
176 the first describing the file type, the latter the creator.
177 This option works properly only for file formats that have the
178 apple-style output defined.
179 .It Fl b , Fl Fl brief
180 Do not prepend filenames to output lines (brief mode).
181 .It Fl C , Fl Fl compile
182 Write a
183 .Pa magic.mgc
184 output file that contains a pre-parsed version of the magic file or directory.
185 .It Fl c , Fl Fl checking-printout
186 Cause a checking printout of the parsed form of the magic file.
187 This is usually used in conjunction with the
188 .Fl m
189 option to debug a new magic file before installing it.
190 .It Fl d
191 Prints internal debugging information to stderr.
192 .It Fl E
193 On filesystem errors (file not found etc), instead of handling the error
194 as regular output as POSIX mandates and keep going, issue an error message
195 and exit.
196 .It Fl e , Fl Fl exclude Ar testname
197 Exclude the test named in
198 .Ar testname
199 from the list of tests made to determine the file type.
200 Valid test names are:
201 .Bl -tag -width compress
202 .It apptype
203 .Dv EMX
204 application type (only on EMX).
205 .It ascii
206 Various types of text files (this test will try to guess the text
207 encoding, irrespective of the setting of the
208 .Sq encoding
209 option).
210 .It encoding
211 Different text encodings for soft magic tests.
212 .It tokens
213 Ignored for backwards compatibility.
214 .It cdf
215 Prints details of Compound Document Files.
216 .It compress
217 Checks for, and looks inside, compressed files.
218 .It csv
219 Checks Comma Separated Value files.
220 .It elf
221 Prints ELF file details, provided soft magic tests are enabled and the
222 elf magic is found.
223 .It json
224 Examines JSON (RFC-7159) files by parsing them for compliance.
225 .It soft
226 Consults magic files.
227 .It simh
228 Examines SIMH tape files.
229 .It tar
230 Examines tar files by verifying the checksum of the 512 byte tar header.
231 Excluding this test can provide more detailed content description by using
232 the soft magic method.
233 .It text
234 A synonym for
235 .Sq ascii .
236 .El
237 .It Fl Fl exclude-quiet
238 Like
239 .Fl Fl exclude
240 but ignore tests that
241 .Nm
242 does not know about.
243 This is intended for compatibility with older versions of
244 .Nm .
245 .It Fl Fl extension
246 Print a slash-separated list of valid extensions for the file type found.
247 .It Fl F , Fl Fl separator Ar separator
248 Use the specified string as the separator between the filename and the
249 file result returned.
250 Defaults to
251 .Sq \&: .
252 .It Fl f , Fl Fl files-from Ar namefile
253 Read the names of the files to be examined from
254 .Ar namefile
255 (one per line)
256 before the argument list.
257 Either
258 .Ar namefile
259 or at least one filename argument must be present;
260 to test the standard input, use
261 .Sq -
262 as a filename argument.
263 Please note that
264 .Ar namefile
265 is unwrapped and the enclosed filenames are processed when this option is
266 encountered and before any further options processing is done.
267 This allows one to process multiple lists of files with different command line
268 arguments on the same
269 .Nm
270 invocation.
271 Thus if you want to set the delimiter, you need to do it before you specify
272 the list of files, like:
273 .Dq Fl F Ar @ Fl f Ar namefile ,
274 instead of:
275 .Dq Fl f Ar namefile Fl F Ar @ .
276 .It Fl h , Fl Fl no-dereference
277 This option causes symlinks not to be followed
278 (on systems that support symbolic links).
279 This is the default if the environment variable
280 .Dv POSIXLY_CORRECT
281 is not defined.
282 .It Fl i , Fl Fl mime
283 Causes the
284 .Nm
285 command to output mime type strings rather than the more
286 traditional human readable ones.
287 Thus it may say
288 .Sq text/plain; charset=us-ascii
289 rather than
290 .Dq ASCII text .
291 .It Fl Fl mime-type , Fl Fl mime-encoding
292 Like
293 .Fl i ,
294 but print only the specified element(s).
295 .It Fl k , Fl Fl keep-going
296 Don't stop at the first match, keep going.
297 Subsequent matches will be
298 have the string
299 .Sq "\[rs]012\- "
300 prepended.
301 (If you want a newline, see the
302 .Fl r
303 option.)
304 The magic pattern with the highest strength (see the
305 .Fl l
306 option) comes first.
307 .It Fl l , Fl Fl list
308 Shows a list of patterns and their strength sorted descending by
309 .Xr magic 5
310 strength
311 which is used for the matching (see also the
312 .Fl k
313 option).
314 .It Fl L , Fl Fl dereference
315 This option causes symlinks to be followed, as the like-named option in
316 .Xr ls 1
317 (on systems that support symbolic links).
318 This is the default if the environment variable
319 .Ev POSIXLY_CORRECT
320 is defined.
321 .It Fl m , Fl Fl magic-file Ar magicfiles
322 Specify an alternate list of files and directories containing magic.
323 This can be a single item, or a colon-separated list.
324 If a compiled magic file is found alongside a file or directory,
325 it will be used instead.
326 .It Fl N , Fl Fl no-pad
327 Don't pad filenames so that they align in the output.
328 .It Fl n , Fl Fl no-buffer
329 Force stdout to be flushed after checking each file.
330 This is only useful if checking a list of files.
331 It is intended to be used by programs that want filetype output from a pipe.
332 .It Fl p , Fl Fl preserve-date
333 On systems that support
334 .Xr utime 3
335 or
336 .Xr utimes 2 ,
337 attempt to preserve the access time of files analyzed, to pretend that
338 .Nm
339 never read them.
340 .It Fl P , Fl Fl parameter Ar name=value
341 Set various parameter limits.
342 .Bl -column "elf_phnum" "Default" "XXXXXXXXXXXXXXXXXXXXXXXXXXX" -offset indent
343 .It Sy "Name" Ta Sy "Default" Ta Sy "Explanation"
344 .It Li bytes Ta 1M Ta max number of bytes to read from file
345 .It Li elf_notes Ta 256 Ta max ELF notes processed
346 .It Li elf_phnum Ta 2K Ta max ELF program sections processed
347 .It Li elf_shnum Ta 32K Ta max ELF sections processed
348 .It Li encoding Ta 65K Ta max number of bytes to determine encoding
349 .It Li indir Ta 50 Ta recursion limit for indirect magic
350 .It Li name Ta 100 Ta use count limit for name/use magic
351 .It Li regex Ta 8K Ta length limit for regex searches
352 .El
353 .It Fl r , Fl Fl raw
354 Don't translate unprintable characters to \eooo.
355 Normally
356 .Nm
357 translates unprintable characters to their octal representation.
358 .It Fl s , Fl Fl special-files
359 Normally,
360 .Nm
361 only attempts to read and determine the type of argument files which
362 .Xr stat 2
363 reports are ordinary files.
364 This prevents problems, because reading special files may have peculiar
365 consequences.
366 Specifying the
367 .Fl s
368 option causes
369 .Nm
370 to also read argument files which are block or character special files.
371 This is useful for determining the filesystem types of the data in raw
372 disk partitions, which are block special files.
373 This option also causes
374 .Nm
375 to disregard the file size as reported by
376 .Xr stat 2
377 since on some systems it reports a zero size for raw disk partitions.
378 .It Fl S , Fl Fl no-sandbox
379 On systems where libseccomp
380 .Pa ( https://github.com/seccomp/libseccomp )
381 is available, the
382 .Fl S
383 option disables sandboxing which is enabled by default.
384 This option is needed for
385 .Nm
386 to execute external decompressing programs,
387 i.e. when the
388 .Fl z
389 option is specified and the built-in decompressors are not available.
390 On systems where sandboxing is not available, this option has no effect.
391 .It Fl v , Fl Fl version
392 Print the version of the program and exit.
393 .It Fl z , Fl Fl uncompress
394 Try to look inside compressed files.
395 .It Fl Z , Fl Fl uncompress-noreport
396 Try to look inside compressed files, but report information about the contents
397 only not the compression.
398 .It Fl 0 , Fl Fl print0
399 Output a null character
400 .Sq \e0
401 after the end of the filename.
402 Nice to
403 .Xr cut 1
404 the output.
405 This does not affect the separator, which is still printed.
406 .Pp
407 If this option is repeated more than once, then
408 .Nm
409 prints just the filename followed by a NUL followed by the description
410 (or ERROR: text) followed by a second NUL for each entry.
411 .It Fl -help
412 Print a help message and exit.
413 .El
414 .Sh ENVIRONMENT
415 The environment variable
416 .Ev MAGIC
417 can be used to set the default magic file name.
418 If that variable is set, then
419 .Nm
420 will not attempt to open
421 .Pa $HOME/.magic .
422 .Nm
423 adds
424 .Dq Pa .mgc
425 to the value of this variable as appropriate.
426 The environment variable
427 .Ev POSIXLY_CORRECT
428 controls (on systems that support symbolic links), whether
429 .Nm
430 will attempt to follow symlinks or not.
431 If set, then
432 .Nm
433 follows symlink, otherwise it does not.
434 This is also controlled by the
435 .Fl L
436 and
437 .Fl h
438 options.
439 .Sh FILES
440 .Bl -tag -width /usr/share/misc/magic.mgc -compact
441 .It Pa /usr/share/misc/magic.mgc
442 Default compiled list of magic.
443 .It Pa /usr/share/misc/magic
444 Directory containing default magic files.
445 .El
446 .Sh EXIT STATUS
447 .Nm
448 will exit with
449 .Dv 0
450 if the operation was successful or
451 .Dv >0
452 if an error was encountered.
453 The following errors cause diagnostic messages, but don't affect the program
454 exit code (as POSIX requires), unless
455 .Fl E
456 is specified:
457 .Bl -bullet -compact -offset indent
458 .It
459 A file cannot be found
460 .It
461 There is no permission to read a file
462 .It
463 The file type cannot be determined
464 .El
465 .Sh EXAMPLES
466 .Bd -literal -offset indent
467 $ file file.c file /dev/{wd0a,hda}
468 file.c: C program text
469 file: ELF 32-bit LSB executable, Intel 80386, version 1 (SYSV),
470 dynamically linked (uses shared libs), stripped
471 /dev/wd0a: block special (0/0)
472 /dev/hda: block special (3/0)
473
474 $ file -s /dev/wd0{b,d}
475 /dev/wd0b: data
476 /dev/wd0d: x86 boot sector
477
478 $ file -s /dev/hda{,1,2,3,4,5,6,7,8,9,10}
479 /dev/hda: x86 boot sector
480 /dev/hda1: Linux/i386 ext2 filesystem
481 /dev/hda2: x86 boot sector
482 /dev/hda3: x86 boot sector, extended partition table
483 /dev/hda4: Linux/i386 ext2 filesystem
484 /dev/hda5: Linux/i386 swap file
485 /dev/hda6: Linux/i386 swap file
486 /dev/hda7: Linux/i386 swap file
487 /dev/hda8: Linux/i386 swap file
488 /dev/hda9: empty
489 /dev/hda10: empty
490
491 $ file -i file.c file /dev/{wd0a,hda}
492 file.c: text/x-c
493 file: application/x-executable
494 /dev/hda: application/x-not-regular-file
495 /dev/wd0a: application/x-not-regular-file
496
497 .Ed
498 .Sh SEE ALSO
499 .Xr hexdump 1 ,
500 .Xr od 1 ,
501 .Xr strings 1 ,
502 .Xr magic 5
503 .Sh STANDARDS CONFORMANCE
504 This program is believed to exceed the System V Interface Definition
505 of FILE(CMD), as near as one can determine from the vague language
506 contained therein.
507 Its behavior is mostly compatible with the System V program of the same name.
508 This version knows more magic, however, so it will produce
509 different (albeit more accurate) output in many cases.
510 .\" URL: http://www.opengroup.org/onlinepubs/009695399/utilities/file.html
511 .Pp
512 The one significant difference
513 between this version and System V
514 is that this version treats any white space
515 as a delimiter, so that spaces in pattern strings must be escaped.
516 For example,
517 .Bd -literal -offset indent
518 \*[Gt]10 string language impress\ (imPRESS data)
519 .Ed
520 .Pp
521 in an existing magic file would have to be changed to
522 .Bd -literal -offset indent
523 \*[Gt]10 string language\e impress (imPRESS data)
524 .Ed
525 .Pp
526 In addition, in this version, if a pattern string contains a backslash,
527 it must be escaped.
528 For example
529 .Bd -literal -offset indent
530 0 string \ebegindata Andrew Toolkit document
531 .Ed
532 .Pp
533 in an existing magic file would have to be changed to
534 .Bd -literal -offset indent
535 0 string \e\ebegindata Andrew Toolkit document
536 .Ed
537 .Pp
538 SunOS releases 3.2 and later from Sun Microsystems include a
539 .Nm
540 command derived from the System V one, but with some extensions.
541 This version differs from Sun's only in minor ways.
542 It includes the extension of the
543 .Sq \*[Am]
544 operator, used as,
545 for example,
546 .Bd -literal -offset indent
547 \*[Gt]16 long\*[Am]0x7fffffff \*[Gt]0 not stripped
548 .Ed
549 .Sh SECURITY
550 On systems where libseccomp
551 .Pa ( https://github.com/seccomp/libseccomp )
552 is available,
553 .Nm
554 is enforces limiting system calls to only the ones necessary for the
555 operation of the program.
556 This enforcement does not provide any security benefit when
557 .Nm
558 is asked to decompress input files running external programs with
559 the
560 .Fl z
561 option.
562 To enable execution of external decompressors, one needs to disable
563 sandboxing using the
564 .Fl S
565 option.
566 .Sh MAGIC DIRECTORY
567 The magic file entries have been collected from various sources,
568 mainly USENET, and contributed by various authors.
569 Christos Zoulas (address below) will collect additional
570 or corrected magic file entries.
571 A consolidation of magic file entries
572 will be distributed periodically.
573 .Pp
574 The order of entries in the magic file is significant.
575 Depending on what system you are using, the order that
576 they are put together may be incorrect.
577 If your old
578 .Nm
579 command uses a magic file,
580 keep the old magic file around for comparison purposes
581 (rename it to
582 .Pa /usr/share/misc/magic.orig ) .
583 .Sh HISTORY
584 There has been a
585 .Nm
586 command in every
587 .Dv UNIX since at least Research Version 4
588 (man page dated November, 1973).
589 The System V version introduced one significant major change:
590 the external list of magic types.
591 This slowed the program down slightly but made it a lot more flexible.
592 .Pp
593 This program, based on the System V version,
594 was written by Ian Darwin
595 .Aq [email protected]
596 without looking at anybody else's source code.
597 .Pp
598 John Gilmore revised the code extensively, making it better than
599 the first version.
600 Geoff Collyer found several inadequacies
601 and provided some magic file entries.
602 Contributions of the
603 .Sq \*[Am]
604 operator by Rob McMahon,
605 .Aq [email protected] ,
606 1989.
607 .Pp
608 Guy Harris,
609 .Aq [email protected] ,
610 made many changes from 1993 to the present.
611 .Pp
612 Primary development and maintenance from 1990 to the present by
613 Christos Zoulas
614 .Aq [email protected] .
615 .Pp
616 Altered by Chris Lowth
617 .Aq [email protected] ,
618 2000: handle the
619 .Fl i
620 option to output mime type strings, using an alternative
621 magic file and internal logic.
622 .Pp
623 Altered by Eric Fischer
624 .Aq [email protected] ,
625 July, 2000,
626 to identify character codes and attempt to identify the languages
627 of non-ASCII files.
628 .Pp
629 Altered by Reuben Thomas
630 .Aq [email protected] ,
631 2007-2011, to improve MIME support, merge MIME and non-MIME magic,
632 support directories as well as files of magic, apply many bug fixes,
633 update and fix a lot of magic, improve the build system, improve the
634 documentation, and rewrite the Python bindings in pure Python.
635 .Pp
636 The list of contributors to the
637 .Sq magic
638 directory (magic files)
639 is too long to include here.
640 You know who you are; thank you.
641 Many contributors are listed in the source files.
642 .Sh LEGAL NOTICE
643 Copyright (c) Ian F. Darwin, Toronto, Canada, 1986-1999.
644 Covered by the standard Berkeley Software Distribution copyright; see the file
645 COPYING in the source distribution.
646 .Pp
647 The files
648 .Pa tar.h
649 and
650 .Pa is_tar.c
651 were written by John Gilmore from his public-domain
652 .Xr tar 1
653 program, and are not covered by the above license.
654 .Sh BUGS
655 Please report bugs and send patches to the bug tracker at
656 .Pa https://bugs.astron.com/
657 or the mailing list at
658 .Aq [email protected]
659 (visit
660 .Pa https://mailman.astron.com/mailman/listinfo/file
661 first to subscribe).
662 .Sh TODO
663 Fix output so that tests for MIME and APPLE flags are not needed all
664 over the place, and actual output is only done in one place.
665 This needs a design.
666 Suggestion: push possible outputs on to a list, then pick the
667 last-pushed (most specific, one hopes) value at the end, or
668 use a default if the list is empty.
669 This should not slow down evaluation.
670 .Pp
671 The handling of
672 .Dv MAGIC_CONTINUE
673 and printing \e012- between entries is clumsy and complicated; refactor
674 and centralize.
675 .Pp
676 Some of the encoding logic is hard-coded in encoding.c and can be moved
677 to the magic files if we had a !:charset annotation.
678 .Pp
679 Continue to squash all magic bugs.
680 See Debian BTS for a good source.
681 .Pp
682 Store arbitrarily long strings, for example for %s patterns, so that
683 they can be printed out.
684 Fixes Debian bug #271672.
685 This can be done by allocating strings in a string pool, storing the
686 string pool at the end of the magic file and converting all the string
687 pointers to relative offsets from the string pool.
688 .Pp
689 Add syntax for relative offsets after current level (Debian bug #466037).
690 .Pp
691 Make file -ki work, i.e. give multiple MIME types.
692 .Pp
693 Add a zip library so we can peek inside Office2007 documents to
694 print more details about their contents.
695 .Pp
696 Add an option to print URLs for the sources of the file descriptions.
697 .Pp
698 Combine script searches and add a way to map executable names to MIME
699 types (e.g. have a magic value for !:mime which causes the resulting
700 string to be looked up in a table).
701 This would avoid adding the same magic repeatedly for each new
702 hash-bang interpreter.
703 .Pp
704 When a file descriptor is available, we can skip and adjust the buffer
705 instead of the hacky buffer management we do now.
706 .Pp
707 Fix
708 .Dq name
709 and
710 .Dq use
711 to check for consistency at compile time (duplicate
712 .Dq name ,
713 .Dq use
714 pointing to undefined
715 .Dq name
716 ).
717 Make
718 .Dq name
719 /
720 .Dq use
721 more efficient by keeping a sorted list of names.
722 Special-case ^ to flip endianness in the parser so that it does not
723 have to be escaped, and document it.
724 .Pp
725 If the offsets specified internally in the file exceed the buffer size
726 (
727 .Dv HOWMANY
728 variable in file.h), then we don't seek to that offset, but we give up.
729 It would be better if buffer managements was done when the file descriptor
730 is available so we can seek around the file.
731 One must be careful though because this has performance and thus security
732 considerations, because one can slow down things by repeatedly seeking.
733 .Pp
734 There is support now for keeping separate buffers and having offsets from
735 the end of the file, but the internal buffer management still needs an
736 overhaul.
737 .Sh AVAILABILITY
738 You can obtain the original author's latest version by anonymous FTP
739 on
740 .Pa ftp.astron.com
741 in the directory
742 .Pa /pub/file/file-X.YZ.tar.gz .