Home | History | Annotate | Line # | Download | only in isa
mms.c revision 1.6.2.7
      1      1.1   andrew /*-
      2  1.6.2.1  mycroft  * Copyright (c) 1993 Charles Hannum
      3      1.1   andrew  * Copyright (c) 1992, 1993 Erik Forsberg.
      4      1.1   andrew  * All rights reserved.
      5      1.1   andrew  *
      6      1.1   andrew  * Redistribution and use in source and binary forms, with or without
      7      1.1   andrew  * modification, are permitted provided that the following conditions
      8      1.1   andrew  * are met:
      9      1.1   andrew  * 1. Redistributions of source code must retain the above copyright
     10      1.1   andrew  *    notice, this list of conditions and the following disclaimer.
     11      1.1   andrew  *
     12      1.1   andrew  * THIS SOFTWARE IS PROVIDED BY ``AS IS'' AND ANY EXPRESS OR IMPLIED
     13      1.1   andrew  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
     14      1.1   andrew  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN
     15      1.1   andrew  * NO EVENT SHALL I BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
     16      1.1   andrew  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
     17      1.1   andrew  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
     18      1.1   andrew  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
     19      1.1   andrew  * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
     20      1.1   andrew  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
     21      1.1   andrew  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
     22      1.1   andrew  *
     23  1.6.2.7  mycroft  *	$Id: mms.c,v 1.6.2.7 1993/10/11 01:51:33 mycroft Exp $
     24      1.1   andrew  */
     25      1.1   andrew 
     26      1.1   andrew #include "param.h"
     27      1.1   andrew #include "kernel.h"
     28      1.1   andrew #include "systm.h"
     29      1.1   andrew #include "buf.h"
     30      1.1   andrew #include "malloc.h"
     31      1.1   andrew #include "ioctl.h"
     32      1.1   andrew #include "tty.h"
     33      1.1   andrew #include "file.h"
     34      1.1   andrew #include "select.h"
     35      1.1   andrew #include "proc.h"
     36      1.1   andrew #include "vnode.h"
     37  1.6.2.1  mycroft #include "sys/device.h"
     38  1.6.2.7  mycroft 
     39  1.6.2.4  mycroft #include "machine/cpu.h"
     40  1.6.2.7  mycroft #include "machine/mouse.h"
     41  1.6.2.7  mycroft #include "machine/pio.h"
     42      1.1   andrew 
     43  1.6.2.1  mycroft #include "i386/isa/isavar.h"
     44  1.6.2.3  mycroft #include "i386/isa/icu.h"
     45      1.1   andrew 
     46  1.6.2.1  mycroft #define MMS_ADDR	0	/* Offset for register select */
     47  1.6.2.1  mycroft #define MMS_DATA	1	/* Offset for InPort data */
     48  1.6.2.1  mycroft #define MMS_IDENT	2	/* Offset for identification register */
     49  1.6.2.1  mycroft #define	MMS_NPORTS	4
     50  1.6.2.1  mycroft 
     51  1.6.2.1  mycroft #define	MMS_CHUNK	128	/* chunk size for read */
     52  1.6.2.5  mycroft #define	MMS_BSIZE	1020	/* buffer size */
     53  1.6.2.1  mycroft 
     54  1.6.2.1  mycroft struct mms_softc {		/* Driver status information */
     55  1.6.2.2  mycroft 	struct	device sc_dev;
     56  1.6.2.2  mycroft 	struct	isadev sc_id;
     57  1.6.2.2  mycroft 	struct	intrhand sc_ih;
     58  1.6.2.2  mycroft 
     59  1.6.2.5  mycroft 	struct	clist sc_q;
     60  1.6.2.1  mycroft 	struct	selinfo sc_rsel;
     61  1.6.2.1  mycroft 	u_short	sc_iobase;	/* I/O port base */
     62  1.6.2.1  mycroft 	u_char	sc_state;	/* Mouse driver state */
     63  1.6.2.1  mycroft #define MMS_OPEN	0x01	/* Device is open */
     64  1.6.2.1  mycroft #define MMS_ASLP	0x02	/* Waiting for mouse data */
     65  1.6.2.1  mycroft 	u_char	sc_status;	/* Mouse button status */
     66  1.6.2.1  mycroft 	int	sc_x, sc_y;	/* accumulated motion in the X,Y axis */
     67      1.1   andrew };
     68      1.1   andrew 
     69  1.6.2.1  mycroft static int mmsprobe __P((struct device *, struct cfdata *, void *));
     70  1.6.2.1  mycroft static void mmsforceintr __P((void *));
     71  1.6.2.1  mycroft static void mmsattach __P((struct device *, struct device *, void *));
     72  1.6.2.1  mycroft static int mmsintr __P((void *));
     73      1.1   andrew 
     74  1.6.2.1  mycroft struct cfdriver mmscd =
     75  1.6.2.1  mycroft { NULL, "mms", mmsprobe, mmsattach, sizeof (struct mms_softc) };
     76      1.1   andrew 
     77  1.6.2.5  mycroft #define MMSUNIT(dev)	(minor(dev))
     78      1.1   andrew 
     79  1.6.2.1  mycroft static int
     80  1.6.2.1  mycroft mmsprobe(parent, cf, aux)
     81  1.6.2.1  mycroft 	struct device *parent;
     82  1.6.2.1  mycroft 	struct cfdata *cf;
     83  1.6.2.1  mycroft 	void *aux;
     84      1.1   andrew {
     85  1.6.2.1  mycroft 	struct	isa_attach_args *ia = aux;
     86  1.6.2.1  mycroft 	u_short	iobase = ia->ia_iobase;
     87      1.1   andrew 
     88  1.6.2.3  mycroft 	if (iobase == IOBASEUNK)
     89  1.6.2.3  mycroft 		return 0;
     90  1.6.2.3  mycroft 
     91      1.1   andrew 	/* Read identification register to see if present */
     92  1.6.2.1  mycroft 	if (inb(iobase + MMS_IDENT) != 0xde)
     93  1.6.2.1  mycroft 		return 0;
     94      1.1   andrew 
     95      1.1   andrew 	/* Seems it was there; reset */
     96  1.6.2.1  mycroft 	outb(iobase + MMS_ADDR, 0x87);
     97      1.1   andrew 
     98  1.6.2.3  mycroft 	if (ia->ia_irq == IRQUNK) {
     99  1.6.2.3  mycroft 		ia->ia_irq = isa_discoverintr(mmsforceintr, aux);
    100  1.6.2.3  mycroft 		if (ia->ia_irq == IRQNONE)
    101  1.6.2.3  mycroft 			return 0;
    102  1.6.2.3  mycroft 	}
    103      1.1   andrew 
    104  1.6.2.1  mycroft 	/* reset again to disable interrupts */
    105  1.6.2.1  mycroft 	outb(iobase + MMS_ADDR, 0x87);
    106      1.1   andrew 
    107  1.6.2.1  mycroft 	ia->ia_iosize = MMS_NPORTS;
    108  1.6.2.1  mycroft 	ia->ia_drq = DRQUNK;
    109  1.6.2.1  mycroft 	ia->ia_msize = 0;
    110  1.6.2.1  mycroft 	return 1;
    111      1.1   andrew }
    112      1.1   andrew 
    113  1.6.2.1  mycroft static void
    114  1.6.2.1  mycroft mmsforceintr(aux)
    115  1.6.2.1  mycroft 	void *aux;
    116      1.1   andrew {
    117  1.6.2.1  mycroft 	struct	isa_attach_args *ia = aux;
    118  1.6.2.1  mycroft 	u_short	iobase = ia->ia_iobase;
    119      1.1   andrew 
    120  1.6.2.1  mycroft 	/* enable interrupts; expect to get one in 1/60 second */
    121  1.6.2.1  mycroft 	outb(iobase + MMS_ADDR, 0x07);
    122  1.6.2.1  mycroft 	outb(iobase + MMS_DATA, 0x09);
    123      1.1   andrew }
    124      1.1   andrew 
    125  1.6.2.1  mycroft static void
    126  1.6.2.1  mycroft mmsattach(parent, self, aux)
    127  1.6.2.1  mycroft 	struct device *parent, *self;
    128  1.6.2.1  mycroft 	void *aux;
    129      1.1   andrew {
    130  1.6.2.1  mycroft 	struct	mms_softc *sc = (struct mms_softc *)self;
    131  1.6.2.1  mycroft 	struct	isa_attach_args *ia = aux;
    132  1.6.2.1  mycroft 	u_short	iobase = ia->ia_iobase;
    133  1.6.2.1  mycroft 
    134  1.6.2.1  mycroft 	/* other initialization done by mmsprobe */
    135  1.6.2.1  mycroft 	sc->sc_iobase = iobase;
    136  1.6.2.1  mycroft 	sc->sc_state = 0;
    137      1.1   andrew 
    138  1.6.2.2  mycroft 	printf(": Microsoft mouse\n");
    139  1.6.2.3  mycroft 	isa_establish(&sc->sc_id, &sc->sc_dev);
    140  1.6.2.2  mycroft 
    141  1.6.2.3  mycroft 	sc->sc_ih.ih_fun = mmsintr;
    142  1.6.2.3  mycroft 	sc->sc_ih.ih_arg = sc;
    143  1.6.2.3  mycroft 	intr_establish(ia->ia_irq, &sc->sc_ih, DV_TTY);
    144  1.6.2.1  mycroft }
    145      1.1   andrew 
    146  1.6.2.1  mycroft int
    147  1.6.2.1  mycroft mmsopen(dev, flag)
    148  1.6.2.1  mycroft 	dev_t dev;
    149  1.6.2.1  mycroft 	int flag;
    150  1.6.2.1  mycroft {
    151  1.6.2.1  mycroft 	int	unit = MMSUNIT(dev);
    152  1.6.2.1  mycroft 	struct	mms_softc *sc;
    153  1.6.2.1  mycroft 	u_short	iobase;
    154  1.6.2.1  mycroft 
    155  1.6.2.1  mycroft 	if (unit >= mmscd.cd_ndevs)
    156  1.6.2.1  mycroft 		return ENXIO;
    157  1.6.2.2  mycroft 	sc = mmscd.cd_devs[unit];
    158  1.6.2.1  mycroft 	if (!sc)
    159  1.6.2.1  mycroft 		return ENXIO;
    160  1.6.2.1  mycroft 
    161  1.6.2.1  mycroft 	if (sc->sc_state & MMS_OPEN)
    162  1.6.2.1  mycroft 		return EBUSY;
    163  1.6.2.1  mycroft 
    164  1.6.2.5  mycroft 	if (clalloc(&sc->sc_q, MMS_BSIZE, 0) == -1)
    165  1.6.2.5  mycroft 		return ENOMEM;
    166  1.6.2.5  mycroft 
    167  1.6.2.1  mycroft 	sc->sc_state |= MMS_OPEN;
    168  1.6.2.1  mycroft 	sc->sc_status = 0;
    169  1.6.2.1  mycroft 	sc->sc_x = sc->sc_y = 0;
    170  1.6.2.1  mycroft 
    171  1.6.2.1  mycroft 	/* enable interrupts */
    172  1.6.2.1  mycroft 	iobase = sc->sc_iobase;
    173  1.6.2.1  mycroft 	outb(iobase + MMS_ADDR, 0x07);
    174  1.6.2.1  mycroft 	outb(iobase + MMS_DATA, 0x09);
    175      1.1   andrew 
    176  1.6.2.1  mycroft 	return 0;
    177  1.6.2.1  mycroft }
    178      1.1   andrew 
    179  1.6.2.1  mycroft int
    180  1.6.2.1  mycroft mmsclose(dev, flag)
    181  1.6.2.1  mycroft 	dev_t dev;
    182  1.6.2.1  mycroft 	int flag;
    183  1.6.2.1  mycroft {
    184  1.6.2.1  mycroft 	int	unit = MMSUNIT(dev);
    185  1.6.2.2  mycroft 	struct	mms_softc *sc = mmscd.cd_devs[unit];
    186      1.1   andrew 
    187  1.6.2.1  mycroft 	/* disable interrupts */
    188  1.6.2.1  mycroft 	outb(sc->sc_iobase + MMS_ADDR, 0x87);
    189      1.1   andrew 
    190  1.6.2.1  mycroft 	sc->sc_state &= ~MMS_OPEN;
    191      1.1   andrew 
    192  1.6.2.5  mycroft 	clfree(&sc->sc_q);
    193  1.6.2.5  mycroft 
    194  1.6.2.1  mycroft 	return 0;
    195      1.1   andrew }
    196      1.1   andrew 
    197  1.6.2.1  mycroft int
    198  1.6.2.1  mycroft mmsread(dev, uio, flag)
    199  1.6.2.1  mycroft 	dev_t dev;
    200  1.6.2.1  mycroft 	struct uio *uio;
    201  1.6.2.1  mycroft 	int flag;
    202      1.1   andrew {
    203  1.6.2.1  mycroft 	int	unit = MMSUNIT(dev);
    204  1.6.2.2  mycroft 	struct	mms_softc *sc = mmscd.cd_devs[unit];
    205  1.6.2.1  mycroft 	int	s;
    206  1.6.2.1  mycroft 	int	error;
    207  1.6.2.1  mycroft 	size_t	length;
    208  1.6.2.1  mycroft 	u_char	buffer[MMS_CHUNK];
    209      1.1   andrew 
    210      1.1   andrew 	/* Block until mouse activity occured */
    211      1.1   andrew 
    212      1.1   andrew 	s = spltty();
    213  1.6.2.5  mycroft 	while (sc->sc_q.c_cc == 0) {
    214  1.6.2.5  mycroft 		if (flag & IO_NDELAY) {
    215      1.1   andrew 			splx(s);
    216  1.6.2.1  mycroft 			return EWOULDBLOCK;
    217      1.1   andrew 		}
    218  1.6.2.1  mycroft 		sc->sc_state |= MMS_ASLP;
    219  1.6.2.1  mycroft 		if (error = tsleep((caddr_t)sc, PZERO | PCATCH, "mmsrea", 0)) {
    220  1.6.2.1  mycroft 			sc->sc_state &= ~MMS_ASLP;
    221      1.1   andrew 			splx(s);
    222  1.6.2.1  mycroft 			return error;
    223      1.1   andrew 		}
    224      1.1   andrew 	}
    225      1.1   andrew 
    226      1.1   andrew 	/* Transfer as many chunks as possible */
    227      1.1   andrew 
    228  1.6.2.5  mycroft 	while (sc->sc_q.c_cc > 0 && uio->uio_resid > 0) {
    229  1.6.2.5  mycroft 		length = min(sc->sc_q.c_cc, uio->uio_resid);
    230      1.1   andrew 		if (length > sizeof(buffer))
    231      1.1   andrew 			length = sizeof(buffer);
    232      1.1   andrew 
    233  1.6.2.5  mycroft 		/* remove a small chunk from input queue */
    234  1.6.2.5  mycroft 		(void) q_to_b(&sc->sc_q, buffer, length);
    235      1.1   andrew 
    236  1.6.2.5  mycroft 		/* copy data to user process */
    237  1.6.2.1  mycroft 		if (error = uiomove(buffer, length, uio))
    238      1.1   andrew 			break;
    239      1.1   andrew 	}
    240      1.1   andrew 
    241  1.6.2.1  mycroft 	/* reset counters */
    242  1.6.2.1  mycroft 	sc->sc_x = sc->sc_y = 0;
    243      1.1   andrew 
    244      1.1   andrew 	splx(s);
    245  1.6.2.1  mycroft 	return error;
    246      1.1   andrew }
    247      1.1   andrew 
    248  1.6.2.1  mycroft int
    249  1.6.2.1  mycroft mmsioctl(dev, cmd, addr, flag)
    250  1.6.2.1  mycroft 	dev_t dev;
    251  1.6.2.1  mycroft 	int cmd;
    252  1.6.2.1  mycroft 	caddr_t addr;
    253  1.6.2.1  mycroft 	int flag;
    254      1.1   andrew {
    255  1.6.2.1  mycroft 	int	unit = MMSUNIT(dev);
    256  1.6.2.2  mycroft 	struct	mms_softc *sc = mmscd.cd_devs[unit];
    257  1.6.2.1  mycroft 	struct	mouseinfo info;
    258  1.6.2.1  mycroft 	int	s;
    259  1.6.2.1  mycroft 	int	error;
    260      1.1   andrew 
    261      1.1   andrew 	switch (cmd) {
    262  1.6.2.1  mycroft 	    case MOUSEIOCREAD:
    263      1.1   andrew 		s = spltty();
    264      1.1   andrew 
    265  1.6.2.1  mycroft 		info.status = sc->sc_status;
    266  1.6.2.1  mycroft 		if (sc->sc_x || sc->sc_y)
    267      1.1   andrew 			info.status |= MOVEMENT;
    268      1.1   andrew 
    269  1.6.2.1  mycroft 		if (sc->sc_x > 127)
    270      1.1   andrew 			info.xmotion = 127;
    271  1.6.2.1  mycroft 		else if (sc->sc_x < -127)
    272  1.6.2.1  mycroft 			/* bounding at -127 avoids a bug in XFree86 */
    273  1.6.2.1  mycroft 			info.xmotion = -127;
    274      1.1   andrew 		else
    275  1.6.2.1  mycroft 			info.xmotion = sc->sc_x;
    276      1.1   andrew 
    277  1.6.2.1  mycroft 		if (sc->sc_y > 127)
    278      1.1   andrew 			info.ymotion = 127;
    279  1.6.2.1  mycroft 		else if (sc->sc_y < -127)
    280  1.6.2.1  mycroft 			info.ymotion = -127;
    281      1.1   andrew 		else
    282  1.6.2.1  mycroft 			info.ymotion = sc->sc_y;
    283      1.1   andrew 
    284  1.6.2.5  mycroft 		/* reset historical information */
    285  1.6.2.1  mycroft 		sc->sc_x = 0;
    286  1.6.2.1  mycroft 		sc->sc_y = 0;
    287  1.6.2.1  mycroft 		sc->sc_status &= ~BUTCHNGMASK;
    288  1.6.2.5  mycroft 		flushq(&sc->sc_q);
    289      1.1   andrew 
    290      1.1   andrew 		splx(s);
    291      1.1   andrew 		error = copyout(&info, addr, sizeof(struct mouseinfo));
    292      1.1   andrew 		break;
    293      1.1   andrew 
    294  1.6.2.1  mycroft 	    default:
    295      1.1   andrew 		error = EINVAL;
    296      1.1   andrew 		break;
    297  1.6.2.1  mycroft 	}
    298      1.1   andrew 
    299  1.6.2.1  mycroft 	return error;
    300      1.1   andrew }
    301      1.1   andrew 
    302  1.6.2.1  mycroft int
    303  1.6.2.1  mycroft mmsintr(arg)
    304  1.6.2.1  mycroft 	void *arg;
    305      1.1   andrew {
    306  1.6.2.1  mycroft 	struct	mms_softc *sc = (struct mms_softc *)arg;
    307  1.6.2.1  mycroft 	u_short	iobase = sc->sc_iobase;
    308  1.6.2.1  mycroft 	u_char	buttons, changed, status;
    309  1.6.2.1  mycroft 	char	dx, dy;
    310  1.6.2.5  mycroft 	u_char	buffer[5];
    311  1.6.2.1  mycroft 
    312  1.6.2.1  mycroft 	if ((sc->sc_state & MMS_OPEN) == 0)
    313  1.6.2.1  mycroft 		/* interrupts not expected */
    314  1.6.2.1  mycroft 		return 0;
    315      1.1   andrew 
    316      1.1   andrew 	/* Freeze InPort registers (disabling interrupts) */
    317  1.6.2.1  mycroft 	outb(iobase + MMS_ADDR, 0x07);
    318  1.6.2.1  mycroft 	outb(iobase + MMS_DATA, 0x29);
    319      1.1   andrew 
    320  1.6.2.1  mycroft 	outb(iobase + MMS_ADDR, 0);
    321  1.6.2.1  mycroft 	status = inb(iobase + MMS_DATA);
    322      1.1   andrew 
    323      1.1   andrew 	if (status & 0x40) {
    324  1.6.2.1  mycroft 		outb(iobase + MMS_ADDR, 1);
    325  1.6.2.1  mycroft 		dx = inb(iobase + MMS_DATA);
    326  1.6.2.1  mycroft 		dx = (dx == -128) ? -127 : dx;
    327  1.6.2.1  mycroft 		outb(iobase + MMS_ADDR, 2);
    328  1.6.2.1  mycroft 		dy = inb(iobase + MMS_DATA);
    329      1.1   andrew 		dy = (dy == -128) ? 127 : -dy;
    330  1.6.2.1  mycroft 	} else
    331      1.1   andrew 		dx = dy = 0;
    332      1.1   andrew 
    333      1.1   andrew 	/* Unfreeze InPort Registers (re-enables interrupts) */
    334  1.6.2.1  mycroft 	outb(iobase + MMS_ADDR, 0x07);
    335  1.6.2.1  mycroft 	outb(iobase + MMS_DATA, 0x09);
    336      1.1   andrew 
    337  1.6.2.1  mycroft 	buttons = status & BUTSTATMASK;
    338  1.6.2.1  mycroft 	changed = status & BUTCHNGMASK;
    339  1.6.2.1  mycroft 	sc->sc_status = buttons | (sc->sc_status & ~BUTSTATMASK) | changed;
    340  1.6.2.1  mycroft 
    341  1.6.2.1  mycroft 	if (dx || dy || changed) {
    342  1.6.2.5  mycroft 		/* update accumulated movements */
    343  1.6.2.1  mycroft 		sc->sc_x += dx;
    344  1.6.2.1  mycroft 		sc->sc_y += dy;
    345  1.6.2.1  mycroft 
    346  1.6.2.5  mycroft 		buffer[0] = 0x80 | (~status & BUTSTATMASK);
    347  1.6.2.5  mycroft 		buffer[1] = dx;
    348  1.6.2.5  mycroft 		buffer[2] = dy;
    349  1.6.2.5  mycroft 		buffer[3] = buffer[4] = 0;
    350  1.6.2.5  mycroft 		(void) b_to_q(buffer, sizeof buffer, &sc->sc_q);
    351      1.1   andrew 
    352  1.6.2.1  mycroft 		if (sc->sc_state & MMS_ASLP) {
    353  1.6.2.1  mycroft 			sc->sc_state &= ~MMS_ASLP;
    354      1.5   andrew 			wakeup((caddr_t)sc);
    355      1.1   andrew 		}
    356  1.6.2.1  mycroft 		selwakeup(&sc->sc_rsel);
    357  1.6.2.1  mycroft 	}
    358  1.6.2.1  mycroft 
    359  1.6.2.1  mycroft 	return 1;
    360      1.1   andrew }
    361      1.1   andrew 
    362  1.6.2.1  mycroft int
    363  1.6.2.1  mycroft mmsselect(dev, rw, p)
    364  1.6.2.1  mycroft 	dev_t dev;
    365  1.6.2.1  mycroft 	int rw;
    366  1.6.2.1  mycroft 	struct proc *p;
    367      1.1   andrew {
    368  1.6.2.1  mycroft 	int	unit = MMSUNIT(dev);
    369  1.6.2.2  mycroft 	struct	mms_softc *sc = mmscd.cd_devs[unit];
    370  1.6.2.1  mycroft 	int	s;
    371  1.6.2.1  mycroft 	int	ret;
    372      1.1   andrew 
    373      1.1   andrew 	if (rw == FWRITE)
    374  1.6.2.1  mycroft 		return 0;
    375      1.1   andrew 
    376      1.1   andrew 	s = spltty();
    377  1.6.2.5  mycroft 	if (sc->sc_q.c_cc)
    378      1.1   andrew 		ret = 1;
    379      1.1   andrew 	else {
    380  1.6.2.1  mycroft 		selrecord(p, &sc->sc_rsel);
    381      1.1   andrew 		ret = 0;
    382      1.1   andrew 	}
    383      1.1   andrew 	splx(s);
    384      1.1   andrew 
    385  1.6.2.1  mycroft 	return ret;
    386      1.1   andrew }
    387