"Fossies" - the Fresh Open Source Software Archive

Member "afio-2.5.2/README" (30 Nov 2018, 4300 Bytes) of package /linux/misc/afio-2.5.2.tgz:

As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. See also the latest Fossies "Diffs" side-by-side code changes report for "README": 2.5.1_vs_2.5.2.

    1 
    2 This is afio 2.5.2
    3 
    4 To find out if this is the latest version, go to
    5 
    6   http://members.chello.nl/k.holtman/afio.html
    7 
    8 The current maintainer is Koen Holtman (koen.holtman@ieee.org).
    9 
   10 (Alternative e-mail address for the maintainer: k.holtman@chello.nl)
   11 
   12 When mailing the maintainer, please use the word `afio' somewhere in
   13 the subject line, this lowers the chance that your mail will get
   14 accidentally deleted.
   15 
   16 Message from the current maintainer, written in 2018:
   17 
   18 Afio is now in a 'maintenance only' mode, with several years between
   19 formal releases.  'Maintenance only' means that I will be happy to
   20 answer questions, to handle bug and problem reports, and to
   21 incorporate patches that fix bugs, portabiliy problems, and security
   22 issues.  However, it is very unlikely that I will not work on adding
   23 major new features, even if the feature request comes with a patch
   24 file implementing the feature.
   25 
   26 The main concern that drives my maintenance policy is to avoid
   27 creating new bugs that would cause the backup process to silently
   28 fail.  Because of this concern, I do a lot of manual reviewing and
   29 testing for every patch I receive.  I have concluded that I simply do
   30 not have the time (and interest level) anymore to do this for patches
   31 adding new features.  My interest has declined because since about
   32 2005, hard drives have become so cheap that making fault tolerant
   33 compressed archive files for writing to tapes of floppy disks, as afio
   34 can do, has become less and less relevant to the needs of average
   35 Linux user.  I make my personal system backups using rsync on a
   36 detachable hard drive.
   37 
   38 
   39 >> See the first lines of afio.c for licensing/redistribution information <<
   40 
   41 --------------------------------------------------------------------------
   42 
   43 Afio makes cpio-format archives.  It deals somewhat gracefully with
   44 input data corruption.  Supports multi-volume archives during
   45 interactive operation.  Afio can make compressed archives that are
   46 much safer than compressed tar or cpio archives.  Afio is best used as
   47 an `archive engine' in a backup script.
   48 
   49 Since version 2.4.8beta1, afio supports files greater than 2 GB.
   50 
   51 --------------------------------------------------------------------------
   52 
   53 See the file INSTALLATION for installation instructions.
   54 
   55 See the file SCRIPTS for more information on backup scripts that use
   56 afio.
   57 
   58 See the file PORTING for information on compiling afio on non-Linux
   59 machines.
   60 
   61 ---------------------------------------------------------------------------
   62 
   63 This afio version is based on a Linux port of afio 2.3.  Since the
   64 original port, significant functionality has been added and some bugs
   65 were removed.  While primarily intended for use under Linux, this code
   66 should be portable to other UNIX versions.  As far as I know, there
   67 has been no afio development beyond 2.3 outside the Linux community.
   68 Thus, it should be safe to advertise ports of this code to other UNIX
   69 versions as ports of afio version 2.4.1.
   70 
   71 ---------------------------------------------------------------------------
   72 
   73 Afio has far too many options and features (some of which are not even
   74 in the manual page).  Anything in afio that doesn't relate to reading
   75 or writing an archive from/to a simple file or pipe or backing up and
   76 restoring from floppies remains untested.
   77 
   78 In particular, nobody has verified if the options -p -d -e -g -h -j -l
   79 -m -u and -R and the special case archive name `!command' really do
   80 what they claim to do.
   81 
   82 Typical `tested' afio uses are
   83  ... | afio -o -v -s 1440k -F -Z /dev/fd0H1440
   84  afio -oZvx /tmp/pipe1 </tmp/pipe2
   85  afio -i -Z -k -v -x -n /tmp/pipe1
   86  ... | afio -s 512m -c 1024 -Z -T 20k -G 1 -E /backup/compressed -v -o \
   87        -L /backup/LOG -z /dev/tape 2>/dev/tty8 >/var/adm/backup
   88 
   89 WARNING1: the code for -F (and -f and -K) is a complete mess.  It will
   90 probably work in the normal case, but don't expect it to handle a
   91 write/verify error correctly.  If you get such an error, best thing is
   92 to restart afio completely.
   93 
   94 WARNING2:The remote archive facilites (host:/file archive names) have
   95 not been exhaustively tested. These facilities have seen a lot of
   96 real-life use though.  However, there may be bugs in the code for
   97 error handling and error reporting with remote archives.
   98 
   99 ---------------------------------------------------------------------------
  100