DataMuseum.dk

top - metrics - download

    Length: 3499 (0xdab)
    Types: TextFile
    Notes: UNIX file
    Names: »far.1«

└─⟦26887b7e0⟧ Bits:30009717 Comet 32 harddisk image
    └─⟦28c352965⟧ »/a« UNIX Filesystem
        └─⟦this⟧ »usr/man/man1/far.1« 

TextFile

.ig
	@(#)far.1	2.1	7/1/84
	@(#)Copyright (C) 1983 by National Semiconductor Corp.
..
.TH FAR 1
.UC 4
.SH NAME
far \- floppy archiver
.SH SYNOPSIS
.B far
[
.B \-crxtu
] [
.B \-vpwa0123
] [
.B \-s
secsiz] [
.B \-i
ident] [
.B \-b bufsiz ] [
.B \-f
file] [file1...]
.SH DESCRIPTION
.PP
.I Far
is similar to but not compatible with the tape archiver
.I tar
(1).
.I Far
saves and restores files on floppy diskettes.
An argument not beginning with "-" is taken to be
a file name or a directory name.
In all cases, appearance of a directory name refers to
the files and (recursively) subdirectories of that directory.
The archive can consist of several diskettes.
Before reading or writing a diskette,
.I far
writes a prompt to the terminal and waits for a
carriage return.
.PP
Options specifying function (one must be given):
.TP 8
.B  \-c
A new set of diskettes is created and the named files are
written on it.
.TP 8
.B  \-r
The named files are added to the end of a previously
created set.
.TP 8
.B  \-x
The named files are extracted from the diskettes.
If the named file matches a directory whose contents 
had been written onto the diskettes, this directory
is (recursively) extracted.
The owner, modification time, and mode are restored (if possible).
If no file argument is given, the entire content of the
diskettes is extracted.
Note that if multiple entries specifying the same file
are on the diskettes, the last one overwrites
all earlier.
.TP 8
.B  \-t
The names of the specified files are listed each time they occur
on the diskettes.
If no file argument is given,
all of the names on the diskettes are listed.
.TP 8
.B  \-u
The named files are added to the diskettes if either they
are not already there or have
been modified since last put on the diskettes.
.PP
Options modifying the function:
.TP 8
.B  \-v
Verbose. Type name of each file as it is read or written.
.TP 8
.B  \-a
Automatic mode.  Instead of waiting for RETURN,
.I far
waits first for drive not ready, and then for drive ready,
and assumes that this means you've successfully inserted
the next diskette.
.TP 8
.B  \-[0123]
Normally /dev/rflop (drive 0) is used.  These options
select an alternate drive: \-1 selects /dev/rflop1 etc.
.TP 8
.B  \-s nnn 
A diskette is assumed to contain 1600 sectors.  This option
specifies new size nnn.  Higher sectors are less reliable
so even with 1600 sector diskettes you may want to specify
a smaller size.
.TP 8
.B  \-i str
The character string 'str' is used to identify the set of
diskettes.  If diskettes are read and this option is given,
the name on the diskette must match 'str'.
.TP 8
.B  \-b nnn
Gives new buffer size.  This can have significant effect on
the time (real, not cpu) it takes to read and write diskettes.
Default is 12 sectors.
.TP 8
.B  \-p
This option says to restore files to their original modes,
ignoring the present umask(2).  Setuid and sticky information
will also be restored to the super-user.
.PP
.SH EXAMPLES
far -vcs 1200 -i "my files" foo bar
.br
far -vx
.PP
.SH FILES
/dev/rflop*
.br
/tmp/far*
.SH SEE ALSO
tar(1)
.SH DIAGNOSTICS
Complains about bad key characters and floppy read/write errors.
.br
Complains if enough memory is not available to hold
the link tables.
.SH BUGS
There is no way to ask for the
.IR n -th
occurrence of a file.
.br
Floppy errors are handled ungracefully.
.br
The
.B u
option can be slow.
.br
The current limit on file name length is
100 characters.
.SH "FAN MAIL"
Send suggestions for improvements to Enea Data, Malm|.