$Id: README,v 1.6 1995/08/06 09:24:27 vons Exp $ DESCRIPTION This is vd version 1.8, a hex dump and restore utility. This program either creates a hexdump from a binary input stream, or does the inverse, converting a hexdump back to binary data. The idea of the restore function of vd is taken from 'xd' by John Walker (kelvin at autodesk dot com), fixed size record stuff was a suggestion from JALI. Assumed is that a character consists of 8 bits, and that the hex representation of a filesize/offset does not exceed 10 positions (files of 1024GB are not too common anyway :) See the manual page for more information. BUILDING INSTRUCTIONS This code is fully Ansi-C, but should compile fine with most older non-Ansi compilers. vd is known to run on the following systems: FreeBSD 1.x gcc-2.5.4 FreeBSD 2.x gcc-2.6.3 Linux 1.0.9 gcc-2.5.8 Solaris 1.x /bin/cc, acc-3.0, gcc-2.5.8 Solaris 2.x acc-3.0 Atari ST Lattice-C 5.51 MS-DOS Visual-C On Unix systems, just run the 'configure' script, followed by 'make'. On other systems, you should copy config.h.in to config.h, and edit it where needed. NOTE: If your environment has a non-binary stdin or stdout by default, check out the BINARY_MODE macro in vd.c. This not needed under Unix, and is already implemented for the Atari-ST/Lattice-C. DISCLAIMER Use this program at your own risk! AUTHOR Gert-Jan Vons E-MAIL: vons at netcourrier dot com ------------------------------------------------------------------------- CURRENT VERSION: 1.8 1.8 1995/08/06 - 2nd arg no longer specifies the output file, replaced with [-o outputfile] option - fixed POSIX getopt() detection in configure.in - switched to configure 2.x 1.7.2 1994/12/11 Changed: - configure.in, added config.h. - added separate MANIFEST - added distclean target to Makefile - got rid of POSIX.1/POSIX.2 stuff, currently does more harm than good (implementations aren't 100% ok yet...) 1.7.1 1994/07/28 Bugfix: - stdlib.h include should be conditional Changed: - Update of getopt.c 1.7 1994/06/15 Bugfix: - Corrected posix/xpg feature tests. - fixed minor compiler warning (found on NT3.5 beta). - dump mode never used leftmost position on line. Changed: - Added the contents of the VERSION an CHANGES files to the README, in order to reduce the number of files to update for a release. - getopt replacement 1.6.1 1994/05/20 Bugfix : added '#undef const' in vd.c to avoid 'redefined' error (dec ULTRIX, no __STDC__, and -Dconst= from configure) Changed: added 'AC_PROG_CC' to configure.in, so configure will define CC properly in Makefile. 1.6 1994/05/18 Bugfix : vd gave error when last input line had no newline. Changed: Colon now mandatory between address and data, and whitespace is allowed both before and after it. New package format, uses configure. 1.5 1993/10/01 bugfix : linelength check had of-by-one error in \n comparison. added : check to see if input- and output-file are identical. changed: -V option now exits after printing version. 1.4 1993/09/30 bugfix : a "line too long" error showed wrong line number. bugfix : restore aborted with line too long if last line of file has exactly the max length and no trailing newline. minor lintfix, changed putchar(uchar) to putchar((int)uchar). 1.3 1993/09/28 added -f/-F options fixed 'bug' regarding 6digit limit (= filesize of 8Mbyte). removed overflow check, Ulong instead of long. functions now from stdin to stdout. improved performance, avoid repeating calculations by using tables. better error messages. 1.2 1993/08/10 renamed vxd to vd. cleanup, fixed some tiny errors, improved error handling. dump_to_bin() improved and commented. 1.1 1993/07/19 Initial version.