initial checkin of version 0.4

INSTALL

@@ -0,0 +1,37 @@
+$Id: INSTALL,v 1.1 1997/02/23 21:53:31 jochen Rel $
+
+Copyright (c) 1995-1997 Jochen Metzinger, Schrammsweg 33 D,
+20249 Hamburg/Germany <1metzing@informatik.uni-hamburg.de>
+All rights reserved
+
+Unzip
+=====
+To unzip this archiv you should use the -a option to get the text
+files with the correct line end characters (CRLF or LF).
+
+Compiling under Linux
+=====================
+To create new binaries you enter
+
+  $ cd src
+  $ make -f makefile.unx install
+
+Compiling under other UNIX
+==========================
+You have to edit src/err.c and change the variables in makefile.unx.
+
+Compiling under Symantec C compiler/MS-DOS
+==========================================
+To create new binaries you enter
+
+  c> cd src
+  c> make -fmakefile.dos install
+
+or
+
+  c> cd src
+  c> build 
+
+Compiling under other MS-DOS C compiler
+=======================================
+You have to change the variables in build.bat or makefile.dos

README

@@ -0,0 +1,135 @@
+
+ctools version 0.4
+
+Copyright (c) 1995-1997 Jochen Metzinger, Schrammsweg 33 D,
+20249 Hamburg/Germany <1metzing@informatik.uni-hamburg.de>
+All rights reserved
+
+
+This archive contains ctools, programs for accessing C64 and C128
+CP/M disk images (*.D64).
+
+
+Copyright
+---------
+
+ctools is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation; either version 2, or (at your option)
+any later version.
+
+ctools is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License in COPYING for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program; if not, write to the Free Software
+Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+
+
+How to start?
+-------------
+
+Read INSTALL for more information on compiling. In the directory bin
+I have put MSDOS-binary files *.exe and Linux-ELF-binaries that are
+compiled for libc.so.5.4.7. In the directory doc there are the man
+pages for all commands. For MSDOS I have included plain cat pages. All
+commands understand the option  "--help"  which output a help text.
+
+
+Files
+-----
+
+COPYING		GNU General Public License
+README		this file
+INSTALL		hints for compiling ctools
+
+bin/		binaries
+  d64dump	view c64 disk images -- Linux/ELF
+  biosdump	view c64/c128 CP/M disk images -- Linux/ELF
+  cformat	create empty c64/c128 CP/M disk images -- Linux/ELF
+  ctools	manipulate c64/c128 CP/M disk images -- Linux/ELF
+  d64dump.exe	view c64 disk images -- MSDOS
+  biosdump.exe	view c64/c128 CP/M disk images -- MSDOS
+  cformat.exe	create empty c64/c128 CP/M disk images -- MSDOS
+  ctools.exe	manipulate c64/c128 CP/M disk images -- MSDOS
+
+doc/		documents
+  d64dump.1	man page of d64dump(1)
+  biosdump.1	man page of biosdump(1)
+  cformat.1	man page of cformat(1)
+  ctools.1	man page of ctools(1)
+  d64.5		man page of d64(5)
+  d64dump.cat	cat page of d64dump(1) -- MSDOS
+  biosdump.cat	cat page of biosdump(1) -- MSDOS
+  cformat.cat	cat page of cformat(1) -- MSDOS
+  ctools.cat	cat page of ctools(1) -- MSDOS
+  d64.cat	cat page of d64(5) -- MSDOS
+
+src/		sources
+  build.bat	build and install batch file -- MSDOS
+  makefile.dos	Makefile for Symantec C compiler -- MSDOS
+  makefile.unx	Makefile for G++ -- Linux
+  d64dump.cc	simple disk image viewer
+  biosdump.cc	simple CP/M disk image viewer
+  cformat.cc	create empty disk images
+  ctools.cc	main programm of ctools
+  bios.h	bios interface (like CP/M BIOS)
+  bios.cc	-"-
+  bitstr.h	dynamic array of bits
+  bitstr.cc	-"-
+  d64.h		access (c1541 and c1571) disk images
+  d64.cc	-"-
+  dir.h		the directory
+  dir.cc	-"-
+  dump.h	output memory dumps
+  dump.cc	-"-
+  err.h		handle errors
+  err.cc	-"-
+  fcb.h		handle file control blocks
+  fcb.cc	-"-
+  file.h	file usage
+  file.cc	-"-
+  global.h	global definitions
+  misc.h	misc routines
+  misc.cc	-"-
+  tools.h	user tools
+  tools.cc	-"-
+
+src/getopt	sources of getopt() -- MSDOS
+  getopt.h	GNU's getopt() from glibc -- MSDOS
+  getopt.c	-"-
+  getopt1.c	-"-
+  getopt.cat	cat page of getopt(3) -- MSDOS
+
+
+Version History
+---------------
+
+Version 0.1 -- July 1995
+* First (unpublished) work for C128 singel sided CP/M disk images
+* written in TURBO PASCAL under MS-DOS
+
+Version 0.2 -- February 1996
+* test programs
+* BAM manipulation program for C128 (BASIC) and PC
+* support of C64 CP/M disk images
+
+Version 0.2.1 -- July 1996
+* enable reading of read-only files
+
+Version 0.3 -- August 1996
+* remove BAM support and .BAT files
+* support of c128 double sided CP/M disk images
+* cformat (create empty disk images)
+* ctools: Dump and Initdir command
+
+Version 0.4 -- March 1997
+* rewritten in C++ under Linux and MS-DOS
+
+To-Do
+-----
+* Full test of double sided images and initdir
+
+### $Id: README,v 1.1 1997/02/23 22:31:59 jochen Rel $ ###

doc/biosdump.1

@@ -0,0 +1,50 @@
+.TH BIOSDUMP 1 "1996\-02\-20" "Version 0.4"
+.\" $Id: biosdump.1,v 1.1 1997/02/20 23:29:31 jochen Rel $
+.\" Copyright (c) 1995-1996  Jochen Metzinger.
+.\"
+.\" Permission is granted to make and distribute verbatim copies of
+.\" this manual provided the copyright notice and this permission notice
+.\" are preserved on all copies.
+.\"
+.\" Permission is granted to copy and distribute modified versions of this
+.\" manual under the conditions for verbatim copying, provided that the
+.\" entire resulting derived work is distributed under the terms of a
+.\" permission notice identical to this one.
+.\"
+.\" Permission is granted to copy and distribute translations of this
+.\" manual into another language, under the above conditions for modified
+.\" versions, except that this permission notice may be included in
+.\" translations instead of in the original English.
+.\"
+.SH NAME
+biosdump \- view c64/c128 CP/M disk images
+.SH SYNOPSIS
+.B biosdump
+.RB [ \-h ]
+.RB [ \-\-help ]
+.I image
+.SH DESCRIPTION
+.B biosdump
+is an interactive program that show sectors of a c64/c128 CP/M disk
+image
+.IR image .
+.PP
+You input the address of the sector that you want to exame.
+.B biosdump 
+show you a dump of this sector and expect you to input the next
+address.
+.PP
+You exit 
+.B biosdump 
+when you input a negative track number.
+.SH OPTIONS
+.TP
+.BR \-h ", " \-\-help
+print a help message on standard output and exit successfully.
+.SH "SEE ALSO"
+.BR d64dump (1),
+.BR cformat (1),
+.BR ctools (1),
+.BR d64 (5)
+.SH AUTHOR
+Jochen Metzinger<1metzing@informatik.uni\-hamburg.de>

doc/biosdump.cat

@@ -0,0 +1,66 @@
+
+
+
+BIOSDUMP(1)					      BIOSDUMP(1)
+
+
+NAME
+       biosdump - view c64/c128 CP/M disk images
+
+SYNOPSIS
+       biosdump [-h] [--help] image
+
+DESCRIPTION
+       biosdump	 is an interactive program that show sectors of a
+       c64/c128 CP/M disk image image.
+
+       You input the address of	 the  sector  that  you	 want  to
+       exame.  biosdump show you a dump of this sector and expect
+       you to input the next address.
+
+       You exit biosdump when you input a negative track  number.
+
+OPTIONS
+       -h, --help
+	      print  a	help  message on standard output and exit
+	      successfully.
+
+SEE ALSO
+       d64dump(1), cformat(1), ctools(1), d64(5)
+
+AUTHOR
+       Jochen Metzinger<1metzing@informatik.uni-hamburg.de>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Version 0.4		    1996-02-20				1
+
+

doc/cformat.1

@@ -0,0 +1,52 @@
+.TH CFORMAT 1 "1996\-02\-20" "Version 0.4"
+.\" $Id: cformat.1,v 1.1 1997/02/20 23:29:31 jochen Rel $
+.\" Copyright (c) 1995-1996  Jochen Metzinger.
+.\"
+.\" Permission is granted to make and distribute verbatim copies of
+.\" this manual provided the copyright notice and this permission notice
+.\" are preserved on all copies.
+.\"
+.\" Permission is granted to copy and distribute modified versions of this
+.\" manual under the conditions for verbatim copying, provided that the
+.\" entire resulting derived work is distributed under the terms of a
+.\" permission notice identical to this one.
+.\"
+.\" Permission is granted to copy and distribute translations of this
+.\" manual into another language, under the above conditions for modified
+.\" versions, except that this permission notice may be included in
+.\" translations instead of in the original English.
+.\"
+.SH NAME
+cformat \- create empty c64/c128 CP/M disk images
+.SH SYNOPSIS
+.B cformat
+.RB [ \-h012 ]
+.RB [ \-\-help ]
+.RB [ \-\-c64 ]
+.RB [ \-\-ss ]
+.RB [ \-\-ds ]
+.I image
+.SH DESCRIPTION
+.B cformat
+creates a new CP/M disk image 
+.BR image .
+.SH OPTIONS
+.TP
+.BR \-0 ", " \-\-c64
+create a c64 disk image.
+.TP
+.BR \-1 ", " \-\-ds
+create a single sided c128 disk image. This is the default option.
+.TP
+.BR \-2 ", " \-\-ds
+create a double sided c128 disk image.
+.TP
+.BR \-h ", " \-\-help
+print a help message on standard output and exit successfully.
+.SH "SEE ALSO"
+.BR d64dump (1),
+.BR biosdump (1),
+.BR ctools (1),
+.BR d64 (5)
+.SH AUTHOR
+Jochen Metzinger<1metzing@informatik.uni\-hamburg.de>