[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
//e and CD-ROM
- Subject: //e and CD-ROM
- From: sturner@pro-ssor.cts.com (Sean Turner)
- Date: Sat, 22 Oct 94 09:03:09 PDT
- Newsgroups: comp.sys.apple2
- Organization: Seven Seas of Rhye [pro-ssor.cts.com] -- Chico, CA
Does anyone think any of the following programs below can be modified (with
author permission of course!) to read CD-ROMs?
Sean
Apple II File Exchange
Version .7 Beta
Copyright 1990 by Chan Wilson
A program to transfer files from HFS (Macintosh) disks to ProDOS disks.
Several different storage methods are available:
o AppleDouble Data File
This transfers only the data fork of the HFS file.
o AppleDouble Header and Data Files
This transfers the HFS file into an AppleDouble file, defined below.
o AppleSingle File
Likewise, this transfers the HFS file into an AppleSingle file.
o Resource Fork as Data File
This transfers only the resource fork of the HFS file, storing it as a BIN
file on the ProDOS disk.
To paraphrase the technotes: AppleSingle and AppleDouble files are a way of
representing files on foreign file systems while preserving all of the file's
home system on file systems that do not support the same attributes.
AppleSingle stores the entire file (resource fork, data fork, finder info,
etc.) as one file, thus its primary purpose is as a storage format. For
example, it is impossible to store forked files on a file system that does
not support forked files (Unix, for example) without mutilating the file in
someway (stuffing, shrinking, binhexing, binsciing, etc.) Using the
AppleSingle format to store the file avoids these problems.
On the other hand, AppleDouble stores the resource fork, file info, finder
info, and other data in an AppleDouble Header file, and the data fork in a
seperate file, called the AppleDouble Data file. This allows for easy
manipulation of the data fork, which is what most people are interested in.
The data fork holds the text in a text file, the sound info in a sound file,
etc.
A2FX gives you the option of creating just the AppleDouble Data file, in
addition to creating a true AppleDouble File. Since most of the information
desired from HFS files is stored in the data fork, this gives you the option
to fetch only the data fork, and not create the header file.
For more information on AppleDouble and AppleSingle files, see the Apple II
File Type Notes.
Enjoy A2FX!
Chan Wilson
Internet:cwilson@nisc.sri.com
GEnie: c.wilson6@genie.geis.com
AOL: CWilson@aol.com
3372 Middlefield Rd
Palo Alto, CA 94306
HFSLink v.3 beta
Copyright (c) 1990 by Scott Blackman
HFSLink links the Apple and Macintosh worlds, providing a way for Apple II
owners to read Mac HFS volumes. Macintosh file and directory conversion is
provided, and HFSLink can deal with the resource forks in a number of ways.
Conversion is allowed between Mac files on any HFS volume, 3.5" disk drive or
20 meg hard disk, or anything else! The current version however, shares the
32 megabyte limit of ProDOS, so it can read only the first 32 meg of a hard
disk.
HFSLink is FreeWare. This means you can copy and distribute it freely, as
long as you don't charge for the program, or separate it from the
accompanying documentation file. Enjoy it and convert away!
This program is still in beta status! This means it has been tested well
enough to release, but testing is not complete. If you should find a
situation in which HFSLink misbehaves, doesn't do exactly what you think it
should do, or outright crashes (in other words, if you find a bug), please
notify me, and I'll get it fixed in the next version. Have fun!
Scott Blackman
Internet: blackman@phoenix.princeton.edu
Snail: Scott Blackman, 1717 Briarcliff Circle, Dalton, GA 30720
What is HFS Convert?
HFS Convert, as of this writing, converts files from a Macintosh HFS volume
into two ProDOS files: one for the data fork and one for the resource fork.
Multiple file selection and directory conversion are supported.
How do I use it?
Quickly:
1. Use "F" if necessary to set the destination ProDOS filetype/auxtype.
2. Use "P" if necessary to set the destination ProDOS prefix.
3. Use "T" to transfer files/folders.
If unsure, *** use SHRINKIT keys ***.
Table of Contents
(you may search for the string <Num>. <Title>, as the following numbered
lines appear exactly in their respective sections)
1. Main Menu (Finding your Macintosh and ProDOS disks, and setting the
prefix)
2. Setting the Filetype
3. About Transferring files (quick version)
4. About those keys (Selection Notes)
5. About the Conversion (Volumes supported, handling directories, more)
6. HFSLink Modify Program (What is it, and do I need to use it?)
7. Hardware Configuration
8. Technical Information
9. Standard Stuff
1. Main Menu
The main menu presents five options: Transfer files, Filetype of Converted
file, Set ProDOS Prefix, About HFSLink, and Quit. The current Prefix is also
on screen. To select, you may use the up/down or left/right arrows, or press
the first letter of the option.
To set the ProDOS prefix, select "ProDOS prefix". Type the complete or
partial pathname at the prompt. Simply pressing RETURN aborts the process.
You do not need to tell HFSLink to find your Macintosh disk; it will scan the
online volumes, prompting you as necessary, for insertion of an HFS disk.
2. Setting the Filetype
You may set the transfer filetype/auxtype by pressing "F". In this version,
you must type the hexadecimal value for filetypes. Some common values are:
$04 TXT / AuxType = record length (usually 0)
$06 BIN / AuxType = starting address
$E0 NuFx (ShrinkIt) / AuxType = $8002
$FF System file / AuxType = $2000 (starting address)
The filetype may also be changed by a number of shareware/freeware file
utilities.
3. About Transferring files (quick version)
After selecting "Transfer Files", the program will read your HFS disk and
present a list of files. At this point you may use the following keys:
up/down arrows Move the cursor bar up/down
left/right arrows Move the cursor bar up/down
ESC Close Directory
space Select/Unselect current file
RETURN Open Directory or Start Transfer
TAB Read another HFS volume
oa-A Select/Unselect all files
oa-G "Go" - Start transfer
oa-O Online volumes
oa-V Volume Info (HFS or MFS)
Period (".") Abort Transfer
4. About those keys (Selection Notes)
ESC will "pop" one directory off of the current path, moving back up one
directory level on the disk. If already in the root directory, this has no
effect.
If RETURN is pressed when no files are selected, the operation will be
performed only on the file beneath the cursor.
TAB will also reread the current device to see if the disk is switched. In
most respects, it behaves exactly as the Standard File Toolset in IIgs
applications.
oa-A marks or unmarks every file. If a file is marked, it will be unmarked,
and vice versa. For instance, pressing oa-A twice has no net effect.
oa-G "Go" is useful mainly to select directories conversion without opening
them at the time of selection.
oa-O (Online volumes) presents a list of online volumes, allowing you to
choose which volume to read. Pressing oa-V or oa-I will give Volume Info of
the volume under the cursor.
oa-V (Volume Info) presents information about an HFS or MFS volume (although
conversion only reads HFS disks): Free Space and Volume size, Volume
Operating system, Volume Created/Modified/Backed up dates.
5. About the Conversion
Conversion is supported for all HFS volumes from 800K 3.5" disks to 40
megabyte hard disks. Although it is possible for an HFS volume to be
unsupported, I have not had it happen to me.
Files and Directories selected undergo filename translation: all
non-alphanumeric characters are replaced with periods ("."), and all
lowercase characters are replaced with uppercase. If a file does not start
with a letter, the letter A is prepended to the name. Filenames are truncated
at 15 characters if necessary. Resource forks have ".R" appended to a 13
character truncated name.
Selection of a directory preserves the heirarchical structure. A directory is
created on the ProDOS disk, and files within that Macintosh folder are placed
within the corresponding ProDOS directory. Conversion of nested folders is
supported.
6. HFSLink Modify Program
To provide greater support for hard drive reading, the HFSLink.Modify program
will perform the following function: On some hard drives, ProDOS may not
recognize the partitioning, and the HFS volume will "start" at a block other
than zero. That is, information that is on logical block zero of the hard
drive (according to a Macintosh), may be on block $80 of the ProDOS device,
and the first $80 blocks may be taken by partitioning information. In this
case, the entire volume is shifted by $80 blocks. A modifying program is
included with HFSLink to patch the HFS disk reading routines to add an offset
to ALL HFS block requests. As the only offset I have encountered is $80, that
is the default. The modifying program creates a temporary file in
/RAM5/HFSTEMP (or any file, if you change the string DF$ in the program),
which it then runs. No other files are modified, and HFSTEMP may be deleted
when finished. The modified HFSTEMP will recognize the hard drive's volume if
the offset is correct; however, it will NOT recognize "normal" HFS volumes,
and you must re-run the unmodified HFSLink.
7. Hardware Configuration
The minimum hardware configuration is an Apple //e, 64K, with 80-column card.
MouseText is optional but makes the displays nicer. No 65C02 opcodes are
used. One-drive systems are supported.
8. Technical Information
Conversion is very simply written. Debugging diagnostics are still printed on
the screen: the file's complete extent record, and several procedures are
still output on the screen.
Errors: Internal errors are numbered much like Apple IIgs Toolbox Errors. The
number is $xxyy, where xx is the subroutine number, and yy is the error
number. For a complete list of errors and subroutines, mail or email me and
I'll send it to you.
Conversion Features: Will correctly locate all extent records for all files,
and for the Catalog Tree, even if it is necessary to read the Extents Tree.
Arbitrary HFS volumes are supported. Directory conversion is supported. One
drive systems are supported.
Bugs: All *KNOWN* bugs have been worked out of the program, but if you can
make anything STRANGE happen, let me know.
9. Standard Stuff
This program is FreeWare. You may copy it and give it to your friends or
upload it to information services as you please. Please remember, however,
that this is a beta revision: instead of payment, I ask that you tell me
about the program. If you find any bugs (especially one that makes conversion
fail), TELL me! If you'd like to see a feature, TELL me! Or, if you like the
program, I'd LOVE to hear that.
Maybe I need to say this, since I mentioned it: ShrinkIT is a registered trademark of L&L Productions, Inc. ShrinkIT is by Andy Nicholas, and is available almost everywhere.
HFSLink Copyright (c) 1990 by Scott Blackman. Any distribution of this
program must include this documentation file.
HFS PREF
BY SCOTT BLACKMAN
HFSLink links the Macintosh and Apple II platforms by providing a way for
Apples to read Mac HFS volumes and save files on ProDOS disks. This
conversion works with all tested HFS volumes, including hard drives, with a
minor problem: Sometimes ProDOS does not recognize the partitioning on the
HFS hard drive, and it appears as though the entire HFS volume is shifted by
a certain number of blocks. For example, normally the Volume Info Block is
located on block 2. On some hard drives, this may turn out to be block $82
(130), or something else. This program loads and modifies HFSLINK and saves a
copy in the current directory. The modified program will shift all HFS block
requests up by a certain amount, allowing you to read these problem hard
drives. You may keep HFSTEMP for reading the hard drive, or you may remake it
from the original if you need it again. All 'normal' HFS volumes will not be
recognized by the modified program, and you will need to re-run the program
to read normal volumes.
HFS MOD
BY SCOTT BLACKMAN
HFSLink links the Macintosh and Apple II platforms by providing a way for
Apples to read Mac HFS volumes and save files on ProDOS disks. This program
modifies the default conversion options used by HFSLink (that is, Data -
Resource fork filetype/auxtype, whether to guess a type based on suffix,
override for files with 'pdos' creator, or whether to convert the resource
and data forks at all. Also, when entering a new filetype, you may use hex
($xx) or a 3-letter mnemonic (like 'TXT' or 'BAS'). HFSLink will recognize 16
mnemonics. This program can customize this list to your personal preference,
if the defaulttypes are not your favorites.
This program loads and modifies HFSLINK and saves a copy in the current
directory. While you may use this as your working copy of HFSLink, I ask that
only the original UNMODIFIED HFSLink program be distributed. This will
prevent multiple nonidentical 'version 1.0' programs.
MSDOS.COPY version 1.3.
MSDOS.COPY is an 8 bit program that can copy files from any directory of a
3.5" MS-DOS diskette to a ProDOS disk. The MS-DOS disk must be inserted in a
drive that is physically capable of reading an MS-DOS diskette. An Apple
SuperDrive (or equivalent) attached to an Apple II 3.5 SuperDrive Controller
card is one such device. So is a "Floptical" drive attached to a SCSI
controller. An Apple SuperDrive attached to the Apple IIgs Smartport will NOT
work. Apple Superdrives are automatically found by the program, a manual
device selection routine must be used to specify other drive types.
This program is very simple. When run it will look for a SuperDrive and ask
for the MS-DOS diskette to be inserted. Pressing any key will cause the
diskette to be read. The root directory will be displayed on the screen. The
arrow keys can be used to scroll up and down through the files. Placing the
cursor (the ">" character) beside a file and pressing "Return" will cause the
program to prompt for a ProDOS filename where the data is to be copied. The
data will then be copied to a TXT file with the name specified.
Placing the cursor beside a directory and pressing "Return" will cause the
program to read the subdirectory and display it on the screen. Pressing the
"ESC" key, or placing the cursor beside the ".." filename and pressing
"Return", will cause the program to reread the previous directory.
Directories more than seven levels deep cannot be handled.
When copying, no conversion of any type (like CR,LF to CR) is done. No disk
swapping is supported. Files cannot be copied from ProDOS to the MS-DOS disk.
MS-DOS files with no data in them will not be copied. Deleted MS-DOS files
cannot be copied.
If no SuperDrives are found the program will ask if manual device entry is
desired. A slot address where a Smartport exists and a device number on that
Smartport are requested. The selected device is then read. If an MS-DOS
diskette is found it will be processed. If the slot and device number of the
device containing the MS-DOS diskette are not known, trial and error can be
used. Standard Smartport READ commands are used, so no harm can be done. The
error codes $11 (invalid device number), $28 (device not connected), and $2F
(no disk in drive) usually mean an invalid device was specified. The error
code $27 (I/O error) usually means the device does not support MS-DOS
diskettes. The message "Not a supported MS-DOS diskette format" usually
means a ProDOS volume has been read. Only MS-DOS 3.5" drive formats are
supported, not 5.25" drives or hard disks.
For the Apple SuperDrive attached to an Apple II SuperDrive controller both
1.44M and 720K diskettes are supported. The disk format must match the
diskette type. A disk formatted 1.44M must be on a HD type diskette (with an
extra hole opposite the write-protect hole), and a disk formatted 720K must
be on a DD type diskette (with no extra hole opposite the write-protect
hole). True IBM PCs can format HD diskettes (with the extra hole) as 720K but
they CANNOT be read with this program.
For other devices the documentation for the device should be consulted.
The "ESC" key can be used to cancel any operation except two. When a ProDOS
filename is prompted for, pressing "Return" with no filename entered will
cancel the copy. When a Smartport device number is prompted for, pressing
"Return" with no device number will exit the program.
The MS-DOS diskette is read using Smartport calls. Standard ProDOS 8 calls
are used to write the copied file.
This program is FREEWARE. It works for me but I cannot guarantee it will work
for everyone.
If you have any problems or suggestions I can be reached on the following
services (I usually log on about once a week):
Genie: HR.MCKAY
Compuserve: 76505,311
BIX: hmckay
Hugh McKay
Montreal, Quebec, Canada
January 1994
AppleSac Apple User's Group
Pete's Place -------- (916) 756-3761
Seven Seas of Rhye -- (916) 891-6542
Files: server@pro-ssor.cts.com
Email: sturner@pro-ssor.cts.com