share/man/man4/man4.mac68k/iwm.4

   1 .\" $NetBSD: iwm.4,v 1.8 2002/01/15 01:47:22 wiz Exp $
   2 .\"     $Id: iwm.4,v 1.9 2009/03/15 11:34:53 joerg Exp $
   3 .\"
   4 .\" Copyright (c) 1997, 1998 Hauke Fath.  All rights reserved.
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\" 2. Redistributions in binary form must reproduce the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer in the
  13 .\"    documentation and/or other materials provided with the distribution.
  14 .\" 3. The name of the author may not be used to endorse or promote products
  15 .\"    derived from this software without specific prior written permission.
  16 .\"
  17 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  18 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  19 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  20 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  21 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  22 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  23 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  24 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  25 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  26 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  27 .\" POSSIBILITY OF SUCH DAMAGE.
  28 .\"
  29 .Dd June 6, 1998
  30 .Dt IWM 4 mac68k
  31 .Os
  32 .Sh NAME
  33 .Nm iwm ,
  34 .Nm fd
  35 .Nd floppy disk driver for IWM and non-DMA SWIM controllers
  36 .Sh SYNOPSIS
  37 .Cd "iwm0 at obio?"
  38 .Cd "fd* at iwm0 drive ?"
  39 .Sh DESCRIPTION
  40 The
  41 .Nm
  42 driver interfaces to the built-in and external floppy disk drives on the
  43 Macintosh. It supports double-density media, written in
  44 Apple's proprietary GCR format. Currently, there is no disklabel
  45 support for the floppy drives. Instead, the
  46 .Nm
  47 driver sets up a fake in-core disklabel, using the minor device
  48 number to select from the supported disk formats.
  49 .Pp
  50 The following formats are supported:
  51 .Bl -column Partition Size sides tracks sectors/track
  52 .It Sy Partition Ta Sy Size Ta Sy sides Ta Sy tracks Ta Sy sectors/track
  53 .It a Ta 800Kb Ta 2 Ta 80 Ta 10 (default)
  54 .It b Ta 400Kb Ta 1 Ta 80 Ta 10
  55 .It c Ta 800Kb Ta 2 Ta 80 Ta 10
  56 .El
  57 .Pp
  58 (The above table describes the logical mapping as implemented by the
  59 driver; the physical layout of GCR floppies has 8..12 sectors per track.)
  60 .Sh FORMATTING
  61 The
  62 .Nm
  63 driver does currently not support floppy disk formatting.
  64 .Sh SEE ALSO
  65 Apple Computer, Inc.: "Inside Macintosh", Vol III-33f. (Addison-Wesley)
  66 .Pp
  67 Apple Computer, Inc.: "New Technical Notes DV 17 - Sony Driver"
  68 .Pp
  69 Neil Parker: "iwmstuff"
  70 .Pp
  71 .Xr eject 1
  72 .Sh HISTORY
  73 The
  74 .Nm
  75 interface first appeared in
  76 .Nx 1.4 .
  77 .Sh AUTHORS
  78 Hauke Fath put together the beginnings of the
  79 .Nm
  80 driver in 1996 from the sparse documentation in "Inside Macintosh",
  81 Neil Parker's "iwmstuff" documentation for the Apple IIgs and a long,
  82 hard look at the .Sony driver.
  83 .Sh BUGS
  84 The FFS code is incapable of dealing with a varying number of
  85 sectors per track. We have to fake a mapping and so lose FFS support
  86 for hardware parameters like transition times.
  87 .Pp
  88 The driver only supports an obsolete format.