changes

一套客户/服务器模式的备份系统代码,跨平台,支持linux,AIX, IRIX, FreeBSD, Digital Unix (OSF1), Solaris and HP-UX.

3.2.1 - 3.2.1pl1
	- Bug fixed: Restore reported errors without real reason and
	  probably restored in wrong order, when compiled with -O...,
	  probably more side effects up to no working high-level
	  programs (full_backup, incr_backup, verify, ...)

3.2.1 - 3.2.2
	- A full backup split into pieces does no longer modify the
	  timestamp
	- Built-in compression
	- Faster (backward compatible) packing format
	- Bug fixed requiring unnecessary workaround for
	  afrestore -[eEf] on new installation
	- Bug fixed, restore -[eEf] now works together with -[RC]

3.2.2 - 3.2.3
	- Option -G for (full|incr)_backup and afclient to request a
	  new or reused cartridge
	- Completely any-shit-in-filenames-safe, e.g. newlines or non-
	  printable characters are allowed in filenames
	- Cartridge sets may consist of arbitrary cartridges, not only
	  consecutive ranges
	- Enhanced database saving capability through command output
	  saving / command input restoring feature
	- Security fix: Client configuration file must be owned by root,
	  so normal users can't supply their own ones

3.2.3 - 3.2.4
	- Client side ring buffer processing reworked, lots of unneeded
	  system calls removed -> hopefully better performance, fewer
	  problems on the Sun and other System-V like OSes
	- Bug fixed: files with special characters in name were sometimes
	  not found during restore with given filenames
	- Bug fixed: __descrpt had a problem when reading a pipe
	- Insufficiency fixed: client now tells server to not overwrite
	  tapes relevant on this server only (before lock on all servers)
	- Server ID introduced to be able to identify the same server
	  under different hostname/port-combinations (e.g. single-multi)
	- Server now tells about it's version, client evaluates this
	- New option -r for command label_tape to delete the overwritten
	  tape from the cartridge handling database
	- label_tape now updates the cartridge handling database properly
	- Better locking for the cartridge handling database files
	- Bug fixed: memory allocation in del_one_from_Uns32Ranges
	- Tape usage counter (file tape_uses)
	- New serverside callback command Tape-Full-Command
	- New helper program __numset
	- Helper script cartagehandler to automatically move cartridges
	  to other sets
	- Variable client-server-protocol
	- Throughput optimizer varying the client-server-protocol
	- Annoyance fixed: verify no longer tells  x is larger than x
	- Source reorganized: Utilities library can be used independently
	  from afbackup, especially in other projects
	- Bug fixed. When restoring relative to a directory, symlinks
	  pointing to absolute pathnames were not created correctly
	- Parts of restore reworked -> safer, faster: trying to put
	  together subsequent tape files for restore; output modified
	- Insufficiency fixed: -l and -n with -a allowed for afrestore
	- Trivial but terrible (whoooooaaaaahhh) memory leak fixed
	- Problem fixed with multi stream server when first/last client
	  fails to connect successfully (thanks also to Pjotr Klaban)
	- Bug fixed: The device access timeouts did not behave as
	  documented when configuring 0
	- Bug fixed: verify might have hung reading corrupt tape data
	- Usage check for client program fixed
	- Bug fixed: Documentation error on -R for restore stating a
	  directory would be created
	- Bug fixed: reread tape position file after waiting for write
	- File truncation during restore tracked down to misbehaving zlib
	- Default installation directory in Install script changed from
	  /usr/backup to /usr/local/afbackup
	- More appropriate position recording in file index -> faster
	  restore

3.2.4 - 3.2.5
	- All arguments passed to mserver and not recognized are passed on
	  to the server subprocess, thus -b possible in /etc/inetd.conf
	- Fixed bogus error message during restore, stating that errors
	  occurred, though there were none
	- Optional CRC32 checksumming on each file, especially, if not
	  compressed (zlib is required nonetheless)
	- Real compression factor is reported in statistics taking only
	  compressed files into account
	- More detailed error messages
	- Configurable server status file, optional append mode
	- More convenience replacements in configuration files
	- Timeout for logon to server
	- Restore of filecontents can be forced to relative path, too
	- Option -H removed from afrestore, -W should be used instead
	- Bug fixed: On Solaris or HP-UX the multi stream server might
	  segfault at startup with certain configurations
	- More logical error handling on client side: distinguish between
	  retryable and non-retryable errors
	- Cartridge set access can be restricted to certain clients
	- Bug fixed: Built-in authentication key stuff (no DES) was broken
	- Restoring with unlink: If a directory is restored and an entry
	  with that name exists, that is not a directory, it is unlinked
	- Minor bug fixed: raw tape access was broken through the multi
	  stream server (discouraged anyway) in 3.2.4
	- Workaround for stupid bug in the IRIX-6.5 Headers
	- On Sun and HP ask for and recommend using gcc
	- Documentation errors concerning filesystems as storage media
	  fixed

3.2.5 - 3.2.6
	- Fix for malloc problem on Digital Unix (and probably others (?))
	- Optional full append mode
	- Exit, if confirmation can't be read from TTY or on input timeout
	- Bug fixed: When switching to another cartridge set for backup
	  with a writing position on a tape, that has been set to read-only
	  mode in the meantime, an immediately following verify asks for
	  another tape first before requesting the correct one (this
	  problem has never been reported to me and only matters for verify,
	  not for restore or anything else, so i consider this a minor bug)
	- Documentation update: How afbackup compares to amanda
	- Two-column X-configuration programs
	- I18N/L10N (thanks a lot to "Lele Gaifax" for implementing it)
	- Option -n with -X for remote start will prefix the output lines
	  with the name of the remote host and a colon
	- Also negative timestamps possible (e.g. "supported" by Solaris)
	- Additional security checking for wrong SUID/SGID Flags
	- Multi stream server's client authentication timing reworked
	  (might timeout during connect due to long tape operations)
	- Option to refuse writing to tapes without valid labels
	- Option -m for restore to prevent existing files from overwriting

3.2.6 - 3.2.7
	- Compress/Uncompress program parameters renamed to Process/Unprocess
	  to stress their more general character
	- The unprocess programs for the indexes are written to files, so
	  the (un-)process programs can be safely changed at any time
	- Seperately configurable process and unprocess commands for the
	  index files
	- The restore option -C really will create the directory as stated
	  by earlier documentation
	- Serverside bug fixed: In very rare cases the tape file count
	  might become higher than reality. This makes, that full append
	  mode for this tape does not work any longer, when it is deselected
	  explicitly (cartis -i or clientside -G), No data is endangered to
	  be erased, overwritten or some other way lost
	- Optional variable append mode. Any tape of the right cartridge set
	  with space left is accepted for writing. No fix writing position
	- Some oddities in label_tape cleaned up, e.g. a cartridge will be
	  removed from the set of read-only tapes, when labeled
	- Bug fixed: (full|incr)_backup did not work with LANG != C or unset
	- One more time workaround for IRIX-6 header bug
	- When cartridges are removed on the server (using label_tape or
	  the server message ReuseTapes) the client updates his information
	  and prints a message at backup start time
	- More robust client connect mechanism
	- Multi stream server can be started as daemon (not using inetd)

3.2.7 - 3.2.7pl1
	- full_backup and incr_backup did not work with LANG != C

3.2.7 - 3.2.8
	- (3.2.8 is mainly a maintenance update)
	- Symlinks owned by root:root in a user's directory could not be
	  restored before. This works now, if there's no syscall lchown
	- Tapes can be labeled, while server is waiting (option -F)
	- Build machinery, especially autoconf, enhanced
	- No more sideeffects when installing the programs not in an own,
	  but a public directory
	- Debian source build tree fixed
	- Choice while running Install, whether chown of the serverside var
	  directory and all it's contents should be performed
	- Some texts were still not internationalized
	- More documentation
	- Workaround for remotely started daemons, that do not daemonize
	  properly
	- Most filedescriptors are closed on exec - cleaner implementation
	- Authentication stuff implemented more generally reusable (for gnep)
	- Problems with Tcl/Tk-strings on IRIX and Tk-4.0 fixed
	- Also on Linux filesizes > 2GB supported (if Linux does)
	- Server enhanced, so Solaris is now a tested server side platform
	  (must be >= Solaris-2.6)
	- Clientside logfile is only opened, when there is something to be
	  appended, and closed afterwards - cleaner implementation
	- The minimum restore info can be used in the clientside exit command
	- Client gives up connecting immediately on sure authentication error

3.2.8 - 3.2.8pl1
	- afclient -GQ did not produce correct output on first invocation,
	  what might break verify functionality (no data harmed)
	- afclient's -n option in combination with -X was not documented
	- Minimal restore info might not be found while tape scanning if
	  written by the multi stream server
	- afmserver did segfault, if tape blocksize was > 131076 bytes
	- afmserver made afserver ignore the -b flag (nobuffering)

3.2.8pl1 - 3.2.8pl2
	- If there was an entry for the parameter "LastCartridges:" in the
	  serverside configuration file (though this entry is an old
	  fashioned one, it's use is discouraged, changing to the new style
	  entry is described in the UPGRAGE file under 3.2.2 and the entry
	  is automatically converted by either serverconfig or xserverconfig)
	  AND the entry was empty AND there was no entry for the (new-style)
	  parameter CartridgeSets, THEN the server misbehaved in that it
	  requested cartridge n + 1, when cartridge n was full and there were
	  only n cartridges configured

3.2.8pl2 - 3.2.8pl4
	- make install.client might fail, if DES encryption is not built in

3.2.8pl4 - 3.2.8pl5
	- Bug fixed: server might segfault when writing is requested and
	  no tape with space is available

3.2.8 - 3.3
	- OpenBSD supported
	- Tape locations database
	- Media changer support (1 drive in a media changer per server)
	- New command cart_ctl
	- mtime is saved in index -> file selection/listing for restore
	  using the modification time is correct now, but: index bigger and
	  less compressable
	- Contents of progress text window of xrestore always visible now
	- Server can send mails to current users (%U) on clientside (%H)
	- Server is configurable to write messages to syslog
	- No longer strange server behaviour, if no logging is configured
	- Path replacements also on server side (%L, %B, %V)
	- afclient -v prints out software name and version
	- Bug fixed: Toplevel directories with a name consisting of only 1
	  character were only listed by restore, if the name was given exactly,
	  thus not immediately visible in xafrestore
	- Bug fixed: restoring a filesystem entry with ACLs and several
	  hardlinks produced format error and possibly segfault
	- Cleverer algorithm to select the tape files for emergency restore,
	  -E and -e options of afrestore can be given several times
	- Buggy function in libdes des_3cbc_encrypt only used on request

3.3 - 3.3pl1
	- Stray lines in afrestore -l output, thus also in xafrestore, fixed

3.3pl1 - 3.3pl2
	- copy_tape did not work any more with destination filesystem
	- if built-in compression was turned on and an external program was
	  configured to preprocess the saved files, under certain (in my
	  opinion rare) circumstances verify might stop processing due to
	  a condition similar to a race. Other functionalities e.g. backup
	  or restore were not affected

3.3 - 3.3.1
	- For the entries to save a command can be supplied starting with | 
	- Help dialog geometry adapts to the text length
	- With older minimum restore info the older index is restored, not a
	  new one created (like before). So also data can be restored, that
	  is in indexes, that have already been removed, cause they left the
	  range configured in the NumIndexesToStore parameter. Assumed is
	  of course, that the needed tapes have not been overwritten
	- Filename in minimum restore info is a temporary copy. The constant
	  name turned out to be disadvantadgous for the previous topic
	- New server message DeleteClient to free the tapes of a client
	- When cartridges are removed on the server (using label_tape or the
	  server message ReuseTapes) the clients also update the index files
	- Tested on Linux-2.4
	- The tape blocksize can be changed now without breaking access to
	  older tapes. This feature was a horror to implement and test. If
	  this was commercial software, i'm sure, this had never been done
	- Restore only the newest version of a file, if no timestamp is given,
	  not the same file several times
	- Client requests authentication from server, too, to make sure, it is
	  talking to an afserver, that is really knowing the key -> security
	- Option -T for copy_tape to specify the directory for temporary space
	- The clientside lockfile is now configurable
	- Flag -i for afrestore to ignore the case in filenames
	- Current index might have lost some contents when hitting Ctrl-C

3.3.1 - 3.3.2
	- Restore can be restricted to a supplied set of tapes
	- New command update_indexes to ask the servers for erased tapes
	  and to remove the appropriate entries from the indexes
	- Index cleanup from erased tape entries is now done before backup
	  when starting (full|incr)_backup, not afterwards
	- With afrestore and update_indexes, certain arguments are ignored
	  now, when started by normal users with SetUID root (security)
	- NumIndexesToStore = 0 was incorrectly handled as 1
	- Bug fixed: With certain configurations non-root restore was broken
	- Opening a tape device to test availability should be non-blocking,
	  so with an autochanger the server will never hang on an empty drive
	- The find function did not always work properly with flags FIND_DEPTH
	  and FIND_LOCAL_DEV set -> flag -m or .//. sometimes misbehaved
	- The tape label comment is kept when the tape is automatically labeled
	- The tape read and write positions were not reset when labeling a tape

3.3.2 - 3.3.3
	- Server multithreaded, if POSIX threads available (evtl. -> speed)
	- New utility xafserverstatus
	- Buffer behaviour enhanced for a little more speed on slow filesystems
	- Cleaner implementation of handling trailing pad bytes
	- label_tape on symlink pseudotapes in the filesystem was broken
	- copy_tape reworked, so beginning of read and write can be set to
	  a certain tape file number (option -F)
	- Client identifier in index header line
	- More reliable error detection on the target server during tape copy
	- For writing the correct secondary cartridge number (i.e. a clone)
	  is only accepted after error message and insisting by a maintainer
	- Beautification: verifying the latest backup does no longer complain
	  about a file, that is temporarily needed and saved, but was gone
	- The program changerready (hardlink to cartready) was not installed

3.3.3 - 3.3.3pl1
	- xafrestore did not work, when vardir was not set in config file

3.3.3pl1 - 3.3.3pl2
	- Subprocess exit status sometimes incorrectly evaluated (observed only
	  on Solaris, but maybe some rare confusions were caused by that, too)

3.3.3pl2 - 3.3.3pl3
	- cart_ctl -t should use the 'CartridgeInsertGracetime'
	- cart_ctl -t should not set the cartridge location to unknown, if
	  labeling fails

3.3.3pl3 - 3.3.3pl4
	- Build problems with disabled national language support fixed
	- Wrong newline in changer.conf.chio for FreeBSD removed