akaiutil: ftp-like access to AKAI S1000/S3000 image files and devices
Copyright (c) 2008 by Klaus Michael Indlekofer. All rights reserved.
Note: Special restrictions apply. See disclaimers below and within the distribution.

Release akaiutil-0.1 (13-FEB-2008)



Email: m.indlekofer@gmx.de



Usage:
------

akautil [-h] [-r] [-f] [-c <cdrom-nr> ...] [-p <physdrive-nr> ...] [<input-file> ...]
	-c	CD-ROM drive
	-p	physical drive/disk
	-h	print this info
	-r	read-only mode
	-f	enable floppy format

Example 1: access harddisk images hhh1.img and hhh2.img
akaiutil hhh1.img hhh2.img

Example 2: access harddisk image hhh.img and floppy image fff.img
akaiutil -f hhh.img fff.img
(Note: -f enables access to floppy formats)

Example 3: access Windows physical drive 1 and Windows CD-ROM drive 0
akaiutil -p 1 -c 0

Example 4: access Windows physical drive 2, harddisk image hhh.img, and floppy image fff.img
akaiutil -f -p 2 hhh.img fff.img

Example 5: access UNIX harddisks /dev/da1, /dev/da2, and harddisk image hhh.img
akaiutil /dev/da1 /dev/da2 hhh.img



Warning:
--------

Accessing physical drives might destroy their contents!!! Use at your own risk!!!
Avoid physical drive 0 under Windows which is typically the system disk!!!



Transferring files:
-------------------

* individual files can be copied via "copy"
* individual files can be imported/exported via "put"/"get"
* whole directory and partition trees can be copied via "copyvol" and "copypart"
* whole directory and partition trees can be imported/exported from/to tar archives via "tarput"/"target"
* path names in akaiutil are of the form "/disk/partition/volume/file", e.g. "/disk2/C/VOLUME_007/SINE.S"
* abbreviations:
  ".." = one level up, "." = stay in same directory
  "/N" = "/diskN"
  "/floppyN" = "/diskN/A"
  '_' can be used as a typable replacement for ' ' (space) in file or volume names
* for detailed information about individual akaiutil commands please read the online help infos



Formatting drives and images:
-----------------------------

Low-density floppy size: 800 blocks (1KB) = 800KB

High-density floppy size: 1600 blocks (1KB) = 1600KB

Max. harddisk (or CD-ROM) size: 65535 blocks (8KB) = approx. 512MB

ZIP100 disk size: 12288 blocks (8KB) = 96MB

Number of blocks for standard harddisk partition sizes:
30MB	->	3840 blks
40MB	->	5120 blks
50MB	->	6400 blks
60MB	->	7680 blks

Example 1: create and format S3000 CD-ROM image of max. size
dd if=/dev/zero of=hhh.img bs=8192 count=65535
akaiutil hhh.img
-> formatharddisk3 7680 65536
(this gives 8 partitions of 60MB and 1 partition of approx. 32MB)

Example 2: format ZIP100 drive at Windows physical drive 1 for S1000
akaiutil -p 1
-> formatharddisk 7680 12288
(this gives 1 partition of 60MB and 1 partition of 36MB)

Example 3: create and format S1000 high-density floppy image
dd if=/dev/zero of=fff.img bs=1024 count=1600
akaiutil -f fff.img
-> formatfloppyh
(Note: in order to access a floppy drive to format, read, or write an Akai floppy,
a special floppy driver is required since the Akai low-level format differs from
the standard PC low-level format)



---
The following holds for all files in this distribution (unless stated otherwise on an
individual basis for each file and statement):

These program/data/document/HTML/picture/media files (materials) are distributed in the
hope that they will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty
of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. In no event shall the author be
liable for any direct, indirect, incidental, special, exemplary, or consequential damages
(including, but not limited to, procurement of substitue goods or services; loss of use,
data, or profits; or business interruption) however caused and on any theory of liability,
whether in contract, strict liability, or tort (including negligence or otherwise) arising
in any way out of the use of data/information/software from this distribution, even if
advised of the possibility of such damage. 

The contents of this distribution are intended for educational, non-commercial purposes
only. Materials contained herein are property of their respective owners. If any
copyrighted works/trademarks have been used, please contact the author K. M. Indlekofer
and the item will be either removed or properly credited (at the copyright/trademark
owner's discretion). We have no intention of violating any copyrights or trademarks.
This distribution might use inlining and deep-linking, i.e. links in this distribution
might lead directly to materials on other web sites/distributions (in which case the
target page normally should be listed/credited in a "links" section). The author does
not take responsibility for the contents of any links referred to. We do not necessarily 
endorse, sanction, support, encourage, verify or agree with the contents, opinions or
statements of/on any of the linked pages. These statements hold for all links/references
in all files in this distribution. We are in no way affiliated with any
companies/institutions/individuals which might be mentioned in any manner in this
distribution.

The author does not take responsibility for incorrect, incomplete or misleading information.
Statements are to be considered as the author's free personal opinion. The author does not
necessarly possess any of the items mentioned in files in this distribution.

Files (and the information therein) created by the author K. M. Indlekofer are copyright
(c) by K. M. Indlekofer. Unless protected/restricted otherwise, the author permits
reproduction/redistribution of material contained in this distribution under the condition
that the item is properly credited. Links to items/materials in this distribution are
welcome. Please contact the author K. M. Indlekofer for comments or further questions
and permission to use materials/information from this distribution. 

Some programs/data files are released under the terms of the GNU General Public License
as published by the Free Software Foundation. (Address: Free Software Foundation, Inc.,
59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. Internet: GNU General Public
License (GPL) from The GNU Project) 



---
This product includes software developed by the University of California, Berkeley
and its contributors.

Copyright (c) 1987-2002 The Regents of the University of California.
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice,
   this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
   notice, this list of conditions and the following disclaimer in the
   documentation and/or other materials provided with the distribution.
3. [rescinded 22 July 1999]
4. Neither the name of the University nor the names of its contributors
   may be used to endorse or promote products derived from this software
   without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS
IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.



---
References:

[1] AkaiDisk and its documentation, by Paul Kellett
[2] akaitools, by Hiroyuki Ohsaki
[3] akaifs, by Raymond Dresens and Roger Karis
[4] libakai, by Sbastien Mtrot
[5] Akai manuals



---
End of file
