1 
  2 This is afio 2.4.6.
  3 
  4 The current maintainer is Koen Holtman (koen@win.tue.nl).
  5 
  6 >> See the first lines of afio.c for licensing/redistribution information <<
  7 
  8 --------------------------------------------------------------------------
  9 
 10 Afio makes cpio-format archives.  It deals somewhat gracefully with
 11 input data corruption.  Supports multi-volume archives during
 12 interactive operation.  Afio can make compressed archives that are
 13 much safer than compressed tar or cpio archives.  Afio is best used as
 14 an `archive engine' in a backup script.
 15 
 16 --------------------------------------------------------------------------
 17 
 18 See the file SCRIPTS for more information on backup scripts that use
 19 afio.
 20 
 21 See the file PORTING for information on compiling afio on non-Linux
 22 machines.
 23 
 24 ---------------------------------------------------------------------------
 25 
 26 This afio version is based on a Linux port of afio 2.3.  Since the
 27 original port, significant functionality has been added and some bugs
 28 were removed.  While primarily intended for use under Linux, this code
 29 should be portable to other UNIX versions.  As far as I know, there
 30 has been no afio development beyond 2.3 outside the Linux community.
 31 Thus, it should be safe to advertise ports of this code to other UNIX
 32 versions as ports of afio version 2.4.1.
 33 
 34 ---------------------------------------------------------------------------
 35      
 36 Afio has far too many options and features (some of which are not even
 37 in the manual page).  Anything in afio that doesn't relate to reading
 38 or writing an archive from/to a simple file or pipe or backing up and
 39 restoring from floppies remains untested.
 40 
 41 In particular, nobody has verified if the options -p -d -e -g -h -j -l
 42 -m -u and -R and the special case archive name `!command' really do
 43 what they claim to do.
 44 
 45 Typical `tested' afio uses are
 46  ... | afio -o -v -s 1440k -F -Z /dev/fd0H1440
 47  afio -oZvx /tmp/pipe1 </tmp/pipe2
 48  afio -i -Z -k -v -x -n /tmp/pipe1
 49  ... | afio -s 512m -c 1024 -Z -T 20k -G 1 -E /backup/compressed -v -o \
 50        -L /backup/LOG -z /dev/tape 2>/dev/tty8 >/var/adm/backup
 51 
 52 WARNING1: the code for -F (and -f and -K) is a complete mess.  It will
 53 probably work in the normal case, but don't expect it to handle a
 54 write/verify error correctly.  If you get such an error, best thing is
 55 to restart afio completely.
 56 
 57 WARNING2:The remote archive facilites (host:/file archive names) have
 58 not been exhaustively tested. These facilities have seen a lot of
 59 real-life use though.  However, there may be bugs in the code for
 60 error handling and error reporting with remote archives.
 61 
 62 ---------------------------------------------------------------------------
 63