DataMuseum.dk

Presents historical artifacts from the history of:

ICL Comet 32

This is an automatic "excavation" of a thematic subset of
artifacts from Datamuseum.dk's BitArchive.

See our Wiki for more about ICL Comet 32

Excavated with: AutoArchaeologist - Free & Open Source Software.


top - metrics - download

⟦ef72b56cd⟧ TextFile

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

Derivation

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

TextFile





































































                                                                         1






           FAR(1)             UNIX Programmer's Manual              FAR(1)



           NAME
                far - floppy archiver

           SYNOPSIS
                far [ -crxtu ] [ -vpwa0123 ] [ -s secsiz] [ -i ident] [ -b
                bufsiz ] [ -f file] [file1...]

           DESCRIPTION
                _▶08◀F_▶08◀a_▶08◀r is  similar  to  but  not  compatible  with  the  tape
                archiver  _▶08◀t_▶08◀a_▶08◀r (1).  _▶08◀F_▶08◀a_▶08◀r 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, appear-
                ance of a directory name refers to the files  and  (recur-
                sively) subdirectories of that directory.  The archive can
                consist of several diskettes.  Before reading or writing a
                diskette,  _▶08◀f_▶08◀a_▶08◀r  writes  a prompt to the terminal and waits
                for a carriage return.

                Options specifying function (one must be given):

                -c      A new set of diskettes is created  and  the  named
                        files are written on it.

                -r      The named files are added to the end of  a  previ-
                        ously created set.

                -x      The named files are extracted from the  diskettes.
                        If  the  named file matches a directory whose con-
                        tents had been written onto  the  diskettes,  this
                        directory  is (recursively) extracted.  The owner,
                        modification time, and mode are restored (if  pos-
                        sible).   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 ear-
                        lier.

                -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.

                -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.

                Options modifying the function:

                -v      Verbose. Type name of each file as it is  read  or
                        written.

                -a      Automatic mode.  Instead of  waiting  for  RETURN,
                        _▶08◀f_▶08◀a_▶08◀r  waits first for drive not ready, and then for
                        drive ready, and assumes that  this  means  you've
                        successfully inserted the next diskette.

                -[0123] Normally /dev/rflop  (drive  0)  is  used.   These
                        options  select  an  alternate  drive:  -1 selects



                                                                         1






           FAR(1)             UNIX Programmer's Manual              FAR(1)



                        /dev/rflop1 etc.

                -s nnn  A diskette is assumed  to  contain  1600  sectors.
                        This  option  specifies new size nnn.  Higher sec-
                        tors are less reliable so even  with  1600  sector
                        diskettes you may want to specify a smaller size.

                -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'.

                -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.

                -p      This option says to restore files to their  origi-
                        nal  modes, ignoring the present umask(2).  Setuid
                        and sticky information will also  be  restored  to
                        the super-user.

           EXAMPLES
                far -vcs 1200 -i "my files" foo bar
                far -vx

           FILES
                /dev/rflop*
                /tmp/far*

           SEE ALSO
                tar(1)

           DIAGNOSTICS
                Complains about bad key characters and  floppy  read/write
                errors.
                Complains if enough memory is not available  to  hold  the
                link tables.

           BUGS
                There is no way to ask for the _▶08◀n-th occurrence of a file.
                Floppy errors are handled ungracefully.
                The u option can be slow.
                The current limit on file name length is 100 characters.

           FAN MAIL
                Send suggestions for improvements to Enea Data, Malm|.















                                                                         2