1 
  2 This afio version is based on a Linux port of afio 2.3.  Since the
  3 original port, significant functionality has been added and some bugs
  4 were removed.  While primarily intended for use under Linux, this code
  5 should be portable to other UNIX versions.  As far as I know, there
  6 has been no afio development beyond 2.3 outside the Linux community.
  7 Thus, it should be safe to advertise ports of this code to other UNIX
  8 versions as ports of afio version 2.4.1.
  9 
 10 --------------------------------------------------------------------------
 11 
 12 The code in this archive compiles under Linux.
 13 
 14 You will have to tweak the makefile to compile it on other platforms.
 15 
 16 If you make a `clean' port of this code, meaning that you add ifdefs
 17 to the source files and `uncomment this for %s' lines to the makefile,
 18 you may want to send diffs to me (koen@win.tue.nl) so that I can
 19 merge them with the next afio version.  If you encounter any POSIX
 20 compatibility problems, please report them.
 21 
 22 Some potential porting problems:
 23 
 24 1) Availability of fnmatch(), see the makefile.
 25 
 26 2) Changing the makefile to work with your make and C compiler.
 27 
 28 3) Making floppy verify work on your unix flavor.
 29 
 30 The code in afio.c should be highly portable.  However I can not
 31 guarantee it to keep working if changes are made to the defines in the
 32 makefile.  The code in the other .c files was written on a Linux
 33 machine for gcc, and assumes a posixy environment.  I have not tried
 34 it on other machines but on most modern unixes it should compile. I
 35 (koen@win.tue.nl) would like to hear about (un)successful ports
 36 to other machines.
 37 
 38 Some of the afio code is a horrible mess, making incremental changes
 39 very difficult.  A complete rewrite of the floppy disk interfacing
 40 code is probably needed if extensions are to be added.  At the moment
 41 afio is (afaik) the only fault tolerant compressing archiver program
 42 available, but it probably has some bugs lurking in it. Because of
 43 this afio is not an optimal solution. I hope that afio will be
 44 replaced by a compressing version of gnu cpio or by cpio combined with
 45 with a fault tolerant compression backend (probably based on a gzip
 46 library) in the future.
 47 
 48 
 49 Note for SCO porters from Karel Kubat, karel@icce.rug.nl:
 50 
 51   Please read the makefile about the changes needed for fnmatch().
 52   
 53   You may want to change the -DDEFFMTCMD value in the makefile.
 54 
 55   If you encounter any other options which may need changing, please mail me 
 56   at karel@icce.rug.nl. I'm not the maintainer of afio for SCO platforms, but 
 57   I'd like to know if you come across anything spectacular.
 58 
 59 
 60 Note for IRIX porters using the SGI native C compiler (cc):
 61 
 62   Modify the Makefile to use CC=cc, comment out the CFLAGS1 line,
 63   and add 
 64    -Dirix_cc_compatibility
 65   to the CFLAGS line.
 66 
 67 Note for HPUX porters using gcc (maybe some (older?) gcc versions
 68 only):
 69 
 70   These steps seem to be needed to get afio to compile, but I
 71   cannot guarantee that they are sufficient to make it work on HPUX:
 72    - Comment out '8     = -DHAVEFCNTL' in the Makefile
 73    - Remove the '-g' from the CFLAGS1 line in the Makefile.
 74 
 75