Home | History | Annotate | Line # | Download | only in coda
coda_psdev.c revision 1.10
      1  1.10  rvb /*	$NetBSD: coda_psdev.c,v 1.10 1999/04/29 22:20:42 rvb Exp $	*/
      2   1.2  rvb 
      3   1.1  rvb /*
      4   1.2  rvb  *
      5   1.2  rvb  *             Coda: an Experimental Distributed File System
      6   1.2  rvb  *                              Release 3.1
      7   1.2  rvb  *
      8   1.2  rvb  *           Copyright (c) 1987-1998 Carnegie Mellon University
      9   1.2  rvb  *                          All Rights Reserved
     10   1.2  rvb  *
     11   1.2  rvb  * Permission  to  use, copy, modify and distribute this software and its
     12   1.2  rvb  * documentation is hereby granted,  provided  that  both  the  copyright
     13   1.2  rvb  * notice  and  this  permission  notice  appear  in  all  copies  of the
     14   1.2  rvb  * software, derivative works or  modified  versions,  and  any  portions
     15   1.2  rvb  * thereof, and that both notices appear in supporting documentation, and
     16   1.2  rvb  * that credit is given to Carnegie Mellon University  in  all  documents
     17   1.2  rvb  * and publicity pertaining to direct or indirect use of this code or its
     18   1.2  rvb  * derivatives.
     19   1.2  rvb  *
     20   1.2  rvb  * CODA IS AN EXPERIMENTAL SOFTWARE SYSTEM AND IS  KNOWN  TO  HAVE  BUGS,
     21   1.2  rvb  * SOME  OF  WHICH MAY HAVE SERIOUS CONSEQUENCES.  CARNEGIE MELLON ALLOWS
     22   1.2  rvb  * FREE USE OF THIS SOFTWARE IN ITS "AS IS" CONDITION.   CARNEGIE  MELLON
     23   1.2  rvb  * DISCLAIMS  ANY  LIABILITY  OF  ANY  KIND  FOR  ANY  DAMAGES WHATSOEVER
     24   1.2  rvb  * RESULTING DIRECTLY OR INDIRECTLY FROM THE USE OF THIS SOFTWARE  OR  OF
     25   1.2  rvb  * ANY DERIVATIVE WORK.
     26   1.2  rvb  *
     27   1.2  rvb  * Carnegie  Mellon  encourages  users  of  this  software  to return any
     28   1.2  rvb  * improvements or extensions that  they  make,  and  to  grant  Carnegie
     29   1.2  rvb  * Mellon the rights to redistribute these changes without encumbrance.
     30   1.2  rvb  *
     31   1.4  rvb  * 	@(#) coda/coda_psdev.c,v 1.1.1.1 1998/08/29 21:26:45 rvb Exp $
     32   1.2  rvb  */
     33   1.1  rvb 
     34   1.1  rvb /*
     35   1.1  rvb  * Mach Operating System
     36   1.1  rvb  * Copyright (c) 1989 Carnegie-Mellon University
     37   1.1  rvb  * All rights reserved.  The CMU software License Agreement specifies
     38   1.1  rvb  * the terms and conditions for use and redistribution.
     39   1.1  rvb  */
     40   1.1  rvb 
     41   1.1  rvb /*
     42   1.1  rvb  * This code was written for the Coda file system at Carnegie Mellon
     43   1.1  rvb  * University.  Contributers include David Steere, James Kistler, and
     44   1.1  rvb  * M. Satyanarayanan.  */
     45   1.1  rvb 
     46   1.1  rvb /* These routines define the psuedo device for communication between
     47   1.1  rvb  * Coda's Venus and Minicache in Mach 2.6. They used to be in cfs_subr.c,
     48   1.1  rvb  * but I moved them to make it easier to port the Minicache without
     49   1.1  rvb  * porting coda. -- DCS 10/12/94
     50   1.1  rvb  */
     51   1.1  rvb 
     52   1.1  rvb /*
     53   1.1  rvb  * HISTORY
     54   1.4  rvb  * $Log: coda_psdev.c,v $
     55  1.10  rvb  * Revision 1.10  1999/04/29 22:20:42  rvb
     56  1.10  rvb  * Typo/braino?
     57  1.10  rvb  *
     58  1.10  rvb  * Revision 1.9  1998/11/11 19:22:08  rvb
     59  1.10  rvb  * Lookup now passes up an extra flag.  But old veni will
     60  1.10  rvb  * be ok; new veni will check /dev/cfs0 to make sure that a new
     61  1.10  rvb  * kernel is running.
     62   1.9  rvb  * Also, a bug in vc_nb_close iff CODA_SIGNAL's were seen has been
     63   1.9  rvb  * fixed.
     64   1.9  rvb  *
     65   1.9  rvb  * Revision 1.8  1998/11/09 16:36:16  rvb
     66   1.9  rvb  * Change the way unmounting happens to guarantee that the
     67   1.9  rvb  * client programs are allowed to finish up (coda_call is
     68   1.9  rvb  * forced to complete) and release their locks.  Thus there
     69   1.8  rvb  * is a reasonable chance that the vflush implicit in the
     70   1.8  rvb  * unmount will not get hung on held locks.
     71   1.8  rvb  *
     72   1.8  rvb  * Revision 1.7  1998/09/28 17:55:22  rvb
     73   1.8  rvb  * I want to distinguish from DEBUG printouts and CODA_VERBOSE printouts.
     74   1.7  rvb  * The latter are normal informational messages that are sometimes
     75   1.7  rvb  * interesting to view.
     76   1.7  rvb  *
     77   1.7  rvb  * Revision 1.6  1998/09/26 15:24:46  tv
     78   1.7  rvb  * DIAGNOSTIC -> DEBUG for all non-panic messages.  DIAGNOSTIC is only for
     79   1.6   tv  * sanity checks and should not turn on any messages not already printed
     80   1.6   tv  * without it.
     81   1.6   tv  *
     82   1.6   tv  * Revision 1.5  1998/09/25 15:01:13  rvb
     83   1.6   tv  * Conditionalize "stray" printouts under DIAGNOSTIC and DEBUG.
     84   1.5  rvb  * Make files compile if DEBUG is on (from  Alan Barrett).  Finally,
     85   1.5  rvb  * make coda an lkm.
     86   1.5  rvb  *
     87   1.4  rvb  * Revision 1.4  1998/09/15 02:02:59  rvb
     88   1.4  rvb  * Final piece of rename cfs->coda
     89   1.4  rvb  *
     90   1.4  rvb  * Revision 1.3  1998/09/12 15:05:48  rvb
     91   1.3  rvb  * Change cfs/CFS in symbols, strings and constants to coda/CODA
     92   1.3  rvb  * to avoid fs conflicts.
     93   1.3  rvb  *
     94   1.2  rvb  * Revision 1.2  1998/09/08 17:12:47  rvb
     95   1.2  rvb  * Pass2 complete
     96   1.2  rvb  *
     97   1.1  rvb  * Revision 1.1.1.1  1998/08/29 21:26:45  rvb
     98   1.1  rvb  * Very Preliminary Coda
     99   1.1  rvb  *
    100   1.1  rvb  * Revision 1.9  1998/08/28 18:12:17  rvb
    101   1.1  rvb  * Now it also works on FreeBSD -current.  This code will be
    102   1.1  rvb  * committed to the FreeBSD -current and NetBSD -current
    103   1.1  rvb  * trees.  It will then be tailored to the particular platform
    104   1.1  rvb  * by flushing conditional code.
    105   1.1  rvb  *
    106   1.1  rvb  * Revision 1.8  1998/08/18 17:05:15  rvb
    107   1.1  rvb  * Don't use __RCSID now
    108   1.1  rvb  *
    109   1.1  rvb  * Revision 1.7  1998/08/18 16:31:41  rvb
    110   1.1  rvb  * Sync the code for NetBSD -current; test on 1.3 later
    111   1.1  rvb  *
    112   1.1  rvb  * Revision 1.8  1998/06/09 23:30:42  rvb
    113   1.1  rvb  * Try to allow ^C -- take 1
    114   1.1  rvb  *
    115   1.1  rvb  * Revision 1.5.2.8  98/01/23  11:21:04  rvb
    116   1.1  rvb  * Sync with 2.2.5
    117   1.1  rvb  *
    118   1.1  rvb  * Revision 1.5.2.7  98/01/22  22:22:21  rvb
    119   1.3  rvb  * sync 1.2 and 1.3
    120   1.1  rvb  *
    121   1.1  rvb  * Revision 1.5.2.6  98/01/22  13:11:24  rvb
    122   1.1  rvb  * Move make_coda_node ctlfid later so vfsp is known; work on ^c and ^z
    123   1.1  rvb  *
    124   1.1  rvb  * Revision 1.5.2.5  97/12/16  22:01:27  rvb
    125   1.1  rvb  * Oops add cfs_subr.h cfs_venus.h; sync with peter
    126   1.1  rvb  *
    127   1.1  rvb  * Revision 1.5.2.4  97/12/16  12:40:05  rvb
    128   1.3  rvb  * Sync with 1.3
    129   1.1  rvb  *
    130   1.1  rvb  * Revision 1.5.2.3  97/12/10  14:08:24  rvb
    131   1.1  rvb  * Fix O_ flags; check result in coda_call
    132   1.1  rvb  *
    133   1.1  rvb  * Revision 1.5.2.2  97/12/10  11:40:24  rvb
    134   1.1  rvb  * No more ody
    135   1.1  rvb  *
    136   1.1  rvb  * Revision 1.5.2.1  97/12/06  17:41:20  rvb
    137   1.1  rvb  * Sync with peters coda.h
    138   1.1  rvb  *
    139   1.1  rvb  * Revision 1.5  97/12/05  10:39:16  rvb
    140   1.1  rvb  * Read CHANGES
    141   1.1  rvb  *
    142   1.1  rvb  * Revision 1.4.18.9  97/12/05  08:58:07  rvb
    143   1.1  rvb  * peter found this one
    144   1.1  rvb  *
    145   1.1  rvb  * Revision 1.4.18.8  97/11/26  15:28:57  rvb
    146   1.1  rvb  * Cant make downcall pbuf == union cfs_downcalls yet
    147   1.1  rvb  *
    148   1.1  rvb  * Revision 1.4.18.7  97/11/25  09:40:49  rvb
    149   1.1  rvb  * Final cfs_venus.c w/o macros, but one locking bug
    150   1.1  rvb  *
    151   1.1  rvb  * Revision 1.4.18.6  97/11/20  11:46:41  rvb
    152   1.1  rvb  * Capture current cfs_venus
    153   1.1  rvb  *
    154   1.1  rvb  * Revision 1.4.18.5  97/11/18  10:27:15  rvb
    155   1.1  rvb  * cfs_nbsd.c is DEAD!!!; integrated into cfs_vf/vnops.c
    156   1.1  rvb  * cfs_nb_foo and cfs_foo are joined
    157   1.1  rvb  *
    158   1.1  rvb  * Revision 1.4.18.4  97/11/13  22:02:59  rvb
    159   1.1  rvb  * pass2 cfs_NetBSD.h mt
    160   1.1  rvb  *
    161   1.1  rvb  * Revision 1.4.18.3  97/11/12  12:09:38  rvb
    162   1.1  rvb  * reorg pass1
    163   1.1  rvb  *
    164   1.1  rvb  * Revision 1.4.18.2  97/10/29  16:06:09  rvb
    165   1.1  rvb  * Kill DYING
    166   1.1  rvb  *
    167   1.1  rvb  * Revision 1.4.18.1  1997/10/28 23:10:15  rvb
    168   1.1  rvb  * >64Meg; venus can be killed!
    169   1.1  rvb  *
    170   1.1  rvb  * Revision 1.4  1996/12/12 22:10:58  bnoble
    171   1.1  rvb  * Fixed the "downcall invokes venus operation" deadlock in all known cases.
    172   1.1  rvb  * There may be more
    173   1.1  rvb  *
    174   1.1  rvb  * Revision 1.3  1996/11/13 04:14:20  bnoble
    175   1.1  rvb  * Merging BNOBLE_WORK_6_20_96 into main line
    176   1.1  rvb  *
    177   1.1  rvb  * Revision 1.2.8.1  1996/08/22 14:25:04  bnoble
    178   1.1  rvb  * Added a return code from vc_nb_close
    179   1.1  rvb  *
    180   1.1  rvb  * Revision 1.2  1996/01/02 16:56:58  bnoble
    181   1.3  rvb  * Added support for Coda MiniCache and raw inode calls (final commit)
    182   1.1  rvb  *
    183   1.1  rvb  * Revision 1.1.2.1  1995/12/20 01:57:24  bnoble
    184   1.1  rvb  * Added CODA-specific files
    185   1.1  rvb  *
    186   1.1  rvb  * Revision 1.1  1995/03/14  20:52:15  bnoble
    187   1.1  rvb  * Initial revision
    188   1.1  rvb  *
    189   1.1  rvb  */
    190   1.3  rvb 
    191   1.1  rvb /* These routines are the device entry points for Venus. */
    192   1.5  rvb 
    193   1.5  rvb extern int coda_nc_initialized;    /* Set if cache has been initialized */
    194   1.5  rvb 
    195   1.3  rvb #ifdef	_LKM
    196   1.5  rvb #define	NVCODA 4
    197   1.5  rvb #else
    198   1.1  rvb #include <vcoda.h>
    199   1.1  rvb #endif
    200   1.1  rvb 
    201   1.1  rvb #include <sys/param.h>
    202   1.1  rvb #include <sys/systm.h>
    203   1.1  rvb #include <sys/kernel.h>
    204   1.1  rvb #include <sys/malloc.h>
    205   1.1  rvb #include <sys/proc.h>
    206   1.1  rvb #include <sys/mount.h>
    207   1.1  rvb #include <sys/file.h>
    208   1.1  rvb #include <sys/ioctl.h>
    209   1.4  rvb #include <sys/poll.h>
    210   1.4  rvb #include <sys/select.h>
    211   1.4  rvb 
    212   1.4  rvb #include <coda/coda.h>
    213   1.5  rvb #include <coda/cnode.h>
    214   1.1  rvb #include <coda/coda_namecache.h>
    215   1.2  rvb #include <coda/coda_io.h>
    216   1.2  rvb #include <coda/coda_psdev.h>
    217   1.3  rvb 
    218   1.8  rvb #define CTL_C
    219   1.8  rvb 
    220   1.8  rvb int coda_psdev_print_entry = 0;
    221   1.8  rvb static
    222   1.8  rvb int outstanding_upcalls = 0;
    223   1.8  rvb int coda_call_sleep = PZERO - 1;
    224   1.8  rvb #ifdef	CTL_C
    225   1.3  rvb int coda_pcatch = PCATCH;
    226   1.3  rvb #else
    227   1.1  rvb #endif
    228   1.3  rvb 
    229   1.1  rvb #define ENTRY if(coda_psdev_print_entry) myprintf(("Entered %s\n",__FUNCTION__))
    230   1.1  rvb 
    231   1.1  rvb void vcodaattach(int n);
    232   1.1  rvb 
    233   1.1  rvb struct vmsg {
    234   1.1  rvb     struct queue vm_chain;
    235   1.1  rvb     caddr_t	 vm_data;
    236   1.1  rvb     u_short	 vm_flags;
    237   1.1  rvb     u_short      vm_inSize;	/* Size is at most 5000 bytes */
    238   1.1  rvb     u_short	 vm_outSize;
    239   1.1  rvb     u_short	 vm_opcode; 	/* copied from data to save ptr lookup */
    240   1.1  rvb     int		 vm_unique;
    241   1.1  rvb     caddr_t	 vm_sleep;	/* Not used by Mach. */
    242   1.1  rvb };
    243   1.1  rvb 
    244   1.1  rvb #define	VM_READ	    1
    245   1.3  rvb #define	VM_WRITE    2
    246   1.1  rvb #define	VM_INTR	    4
    247   1.3  rvb 
    248   1.1  rvb /* vcodaattach: do nothing */
    249   1.1  rvb void
    250   1.1  rvb vcodaattach(n)
    251   1.1  rvb     int n;
    252   1.1  rvb {
    253   1.1  rvb }
    254   1.1  rvb 
    255   1.1  rvb /*
    256   1.1  rvb  * These functions are written for NetBSD.
    257   1.1  rvb  */
    258   1.1  rvb int
    259   1.1  rvb vc_nb_open(dev, flag, mode, p)
    260   1.1  rvb     dev_t        dev;
    261   1.1  rvb     int          flag;
    262   1.1  rvb     int          mode;
    263   1.1  rvb     struct proc *p;             /* NetBSD only */
    264   1.1  rvb {
    265   1.1  rvb     register struct vcomm *vcp;
    266   1.3  rvb 
    267   1.1  rvb     ENTRY;
    268   1.1  rvb 
    269   1.3  rvb     if (minor(dev) >= NVCODA || minor(dev) < 0)
    270   1.3  rvb 	return(ENXIO);
    271   1.1  rvb 
    272   1.3  rvb     if (!coda_nc_initialized)
    273   1.1  rvb 	coda_nc_init();
    274   1.1  rvb 
    275   1.1  rvb     vcp = &coda_mnttbl[minor(dev)].mi_vcomm;
    276   1.1  rvb     if (VC_OPEN(vcp))
    277   1.1  rvb 	return(EBUSY);
    278   1.1  rvb 
    279   1.1  rvb     bzero(&(vcp->vc_selproc), sizeof (struct selinfo));
    280   1.1  rvb     INIT_QUEUE(vcp->vc_requests);
    281   1.3  rvb     INIT_QUEUE(vcp->vc_replys);
    282   1.3  rvb     MARK_VC_OPEN(vcp);
    283   1.1  rvb 
    284   1.1  rvb     coda_mnttbl[minor(dev)].mi_vfsp = NULL;
    285   1.1  rvb     coda_mnttbl[minor(dev)].mi_rootvp = NULL;
    286   1.1  rvb 
    287   1.1  rvb     return(0);
    288   1.1  rvb }
    289   1.1  rvb 
    290   1.1  rvb int
    291   1.1  rvb vc_nb_close (dev, flag, mode, p)
    292   1.1  rvb     dev_t        dev;
    293   1.1  rvb     int          flag;
    294   1.1  rvb     int          mode;
    295   1.9  rvb     struct proc *p;
    296   1.3  rvb {
    297   1.1  rvb     register struct vcomm *vcp;
    298   1.1  rvb     register struct vmsg *vmp, *nvmp = NULL;
    299   1.1  rvb     struct coda_mntinfo *mi;
    300   1.1  rvb     int                 err;
    301   1.3  rvb 
    302   1.1  rvb     ENTRY;
    303   1.1  rvb 
    304   1.3  rvb     if (minor(dev) >= NVCODA || minor(dev) < 0)
    305   1.1  rvb 	return(ENXIO);
    306   1.1  rvb 
    307   1.1  rvb     mi = &coda_mnttbl[minor(dev)];
    308   1.1  rvb     vcp = &(mi->mi_vcomm);
    309   1.1  rvb 
    310   1.1  rvb     if (!VC_OPEN(vcp))
    311   1.1  rvb 	panic("vcclose: not open");
    312   1.1  rvb 
    313   1.1  rvb     /* prevent future operations on this vfs from succeeding by auto-
    314   1.1  rvb      * unmounting any vfs mounted via this device. This frees user or
    315   1.1  rvb      * sysadm from having to remember where all mount points are located.
    316   1.8  rvb      * Put this before WAKEUPs to avoid queuing new messages between
    317   1.8  rvb      * the WAKEUP and the unmount (which can happen if we're unlucky)
    318   1.8  rvb      */
    319   1.8  rvb     if (!mi->mi_rootvp) {
    320   1.1  rvb 	/* just a simple open/close w no mount */
    321   1.8  rvb 	MARK_VC_CLOSED(vcp);
    322   1.8  rvb 	return 0;
    323   1.8  rvb     }
    324   1.8  rvb 
    325   1.8  rvb     /* Let unmount know this is for real */
    326   1.8  rvb     VTOC(mi->mi_rootvp)->c_flags |= C_UNMOUNTING;
    327   1.1  rvb     if (vfs_busy(mi->mi_vfsp, 0, 0))
    328   1.1  rvb 	return (EBUSY);
    329   1.1  rvb     coda_unmounting(mi->mi_vfsp);
    330   1.1  rvb 
    331  1.10  rvb     /* Wakeup clients so they can return. */
    332   1.1  rvb     for (vmp = (struct vmsg *)GETNEXT(vcp->vc_requests);
    333   1.9  rvb 	 !EOQ(vmp, vcp->vc_requests);
    334   1.1  rvb 	 vmp = nvmp)
    335   1.1  rvb     {
    336   1.3  rvb     	nvmp = (struct vmsg *)GETNEXT(vmp->vm_chain);
    337   1.3  rvb 	/* Free signal request messages and don't wakeup cause
    338   1.3  rvb 	   no one is waiting. */
    339   1.1  rvb 	if (vmp->vm_opcode == CODA_SIGNAL) {
    340   1.1  rvb 	    CODA_FREE((caddr_t)vmp->vm_data, (u_int)VC_IN_NO_DATA);
    341   1.8  rvb 	    CODA_FREE((caddr_t)vmp, (u_int)sizeof(struct vmsg));
    342   1.1  rvb 	    continue;
    343   1.1  rvb 	}
    344   1.8  rvb 	outstanding_upcalls++;
    345   1.1  rvb 	wakeup(&vmp->vm_sleep);
    346   1.1  rvb     }
    347   1.1  rvb 
    348   1.1  rvb     for (vmp = (struct vmsg *)GETNEXT(vcp->vc_replys);
    349   1.8  rvb 	 !EOQ(vmp, vcp->vc_replys);
    350   1.1  rvb 	 vmp = (struct vmsg *)GETNEXT(vmp->vm_chain))
    351   1.1  rvb     {
    352   1.8  rvb 	outstanding_upcalls++;
    353   1.1  rvb 	wakeup(&vmp->vm_sleep);
    354   1.8  rvb     }
    355   1.8  rvb 
    356   1.8  rvb     MARK_VC_CLOSED(vcp);
    357   1.8  rvb 
    358   1.8  rvb     if (outstanding_upcalls) {
    359   1.8  rvb #ifdef	CODA_VERBOSE
    360   1.8  rvb 	printf("presleep: outstanding_upcalls = %d\n", outstanding_upcalls);
    361   1.8  rvb     	(void) tsleep(&outstanding_upcalls, coda_call_sleep, "coda_umount", 0);
    362   1.8  rvb 	printf("postsleep: outstanding_upcalls = %d\n", outstanding_upcalls);
    363   1.8  rvb #else
    364   1.8  rvb     	(void) tsleep(&outstanding_upcalls, coda_call_sleep, "coda_umount", 0);
    365   1.8  rvb #endif
    366   1.8  rvb     }
    367   1.8  rvb 
    368   1.8  rvb     err = dounmount(mi->mi_vfsp, flag, p);
    369   1.1  rvb     if (err)
    370   1.1  rvb 	myprintf(("Error %d unmounting vfs in vcclose(%d)\n",
    371   1.1  rvb 	           err, minor(dev)));
    372   1.1  rvb     return 0;
    373   1.1  rvb }
    374   1.1  rvb 
    375   1.1  rvb int
    376   1.1  rvb vc_nb_read(dev, uiop, flag)
    377   1.1  rvb     dev_t        dev;
    378   1.1  rvb     struct uio  *uiop;
    379   1.1  rvb     int          flag;
    380   1.1  rvb {
    381   1.1  rvb     register struct vcomm *	vcp;
    382   1.1  rvb     register struct vmsg *vmp;
    383   1.1  rvb     int error = 0;
    384   1.3  rvb 
    385   1.1  rvb     ENTRY;
    386   1.1  rvb 
    387   1.3  rvb     if (minor(dev) >= NVCODA || minor(dev) < 0)
    388   1.1  rvb 	return(ENXIO);
    389   1.1  rvb 
    390   1.1  rvb     vcp = &coda_mnttbl[minor(dev)].mi_vcomm;
    391   1.1  rvb     /* Get message at head of request queue. */
    392   1.1  rvb     if (EMPTY(vcp->vc_requests))
    393   1.1  rvb 	return(0);	/* Nothing to read */
    394   1.1  rvb 
    395   1.1  rvb     vmp = (struct vmsg *)GETNEXT(vcp->vc_requests);
    396   1.1  rvb 
    397   1.1  rvb     /* Move the input args into userspace */
    398   1.1  rvb     uiop->uio_rw = UIO_READ;
    399   1.1  rvb     error = uiomove(vmp->vm_data, vmp->vm_inSize, uiop);
    400   1.1  rvb     if (error) {
    401   1.1  rvb 	myprintf(("vcread: error (%d) on uiomove\n", error));
    402   1.5  rvb 	error = EINVAL;
    403   1.1  rvb     }
    404   1.1  rvb 
    405   1.1  rvb #ifdef OLD_DIAGNOSTIC
    406   1.1  rvb     if (vmp->vm_chain.forw == 0 || vmp->vm_chain.back == 0)
    407   1.1  rvb 	panic("vc_nb_read: bad chain");
    408   1.1  rvb #endif
    409   1.1  rvb 
    410   1.1  rvb     REMQUE(vmp->vm_chain);
    411   1.3  rvb 
    412   1.3  rvb     /* If request was a signal, free up the message and don't
    413   1.1  rvb        enqueue it in the reply queue. */
    414   1.1  rvb     if (vmp->vm_opcode == CODA_SIGNAL) {
    415   1.3  rvb 	if (codadebug)
    416   1.3  rvb 	    myprintf(("vcread: signal msg (%d, %d)\n",
    417   1.1  rvb 		      vmp->vm_opcode, vmp->vm_unique));
    418   1.1  rvb 	CODA_FREE((caddr_t)vmp->vm_data, (u_int)VC_IN_NO_DATA);
    419   1.1  rvb 	CODA_FREE((caddr_t)vmp, (u_int)sizeof(struct vmsg));
    420   1.1  rvb 	return(error);
    421   1.1  rvb     }
    422   1.1  rvb 
    423   1.1  rvb     vmp->vm_flags |= VM_READ;
    424   1.1  rvb     INSQUE(vmp->vm_chain, vcp->vc_replys);
    425   1.1  rvb 
    426   1.1  rvb     return(error);
    427   1.1  rvb }
    428   1.1  rvb 
    429   1.1  rvb int
    430   1.1  rvb vc_nb_write(dev, uiop, flag)
    431   1.1  rvb     dev_t        dev;
    432   1.1  rvb     struct uio  *uiop;
    433   1.1  rvb     int          flag;
    434   1.3  rvb {
    435   1.1  rvb     register struct vcomm *	vcp;
    436   1.1  rvb     register struct vmsg *vmp;
    437   1.1  rvb     struct coda_out_hdr *out;
    438   1.1  rvb     u_long seq;
    439   1.1  rvb     u_long opcode;
    440   1.1  rvb     int buf[2];
    441   1.1  rvb     int error = 0;
    442   1.3  rvb 
    443   1.1  rvb     ENTRY;
    444   1.1  rvb 
    445   1.3  rvb     if (minor(dev) >= NVCODA || minor(dev) < 0)
    446   1.1  rvb 	return(ENXIO);
    447   1.1  rvb 
    448   1.1  rvb     vcp = &coda_mnttbl[minor(dev)].mi_vcomm;
    449   1.1  rvb 
    450   1.1  rvb     /* Peek at the opcode, unique without transfering the data. */
    451   1.1  rvb     uiop->uio_rw = UIO_WRITE;
    452   1.1  rvb     error = uiomove((caddr_t)buf, sizeof(int) * 2, uiop);
    453   1.1  rvb     if (error) {
    454   1.1  rvb 	myprintf(("vcwrite: error (%d) on uiomove\n", error));
    455   1.1  rvb 	return(EINVAL);
    456   1.1  rvb     }
    457   1.1  rvb 
    458   1.3  rvb     opcode = buf[0];
    459   1.1  rvb     seq = buf[1];
    460   1.1  rvb 
    461   1.1  rvb     if (codadebug)
    462   1.1  rvb 	myprintf(("vcwrite got a call for %ld.%ld\n", opcode, seq));
    463   1.1  rvb 
    464   1.1  rvb     if (DOWNCALL(opcode)) {
    465   1.1  rvb 	union outputArgs pbuf;
    466   1.3  rvb 
    467   1.1  rvb 	/* get the rest of the data. */
    468   1.1  rvb 	uiop->uio_rw = UIO_WRITE;
    469   1.1  rvb 	error = uiomove((caddr_t)&pbuf.coda_purgeuser.oh.result, sizeof(pbuf) - (sizeof(int)*2), uiop);
    470   1.1  rvb 	if (error) {
    471   1.1  rvb 	    myprintf(("vcwrite: error (%d) on uiomove (Op %ld seq %ld)\n",
    472   1.1  rvb 		      error, opcode, seq));
    473   1.1  rvb 	    return(EINVAL);
    474   1.1  rvb 	    }
    475   1.1  rvb 
    476   1.1  rvb 	return handleDownCall(opcode, &pbuf);
    477   1.1  rvb     }
    478   1.1  rvb 
    479   1.1  rvb     /* Look for the message on the (waiting for) reply queue. */
    480   1.1  rvb     for (vmp = (struct vmsg *)GETNEXT(vcp->vc_replys);
    481   1.1  rvb 	 !EOQ(vmp, vcp->vc_replys);
    482   1.1  rvb 	 vmp = (struct vmsg *)GETNEXT(vmp->vm_chain))
    483   1.1  rvb     {
    484   1.1  rvb 	if (vmp->vm_unique == seq) break;
    485   1.3  rvb     }
    486   1.1  rvb 
    487   1.1  rvb     if (EOQ(vmp, vcp->vc_replys)) {
    488   1.1  rvb 	if (codadebug)
    489   1.1  rvb 	    myprintf(("vcwrite: msg (%ld, %ld) not found\n", opcode, seq));
    490   1.1  rvb 
    491   1.1  rvb 	return(ESRCH);
    492   1.1  rvb 	}
    493   1.1  rvb 
    494   1.1  rvb     /* Remove the message from the reply queue */
    495   1.3  rvb     REMQUE(vmp->vm_chain);
    496   1.1  rvb 
    497   1.1  rvb     /* move data into response buffer. */
    498   1.1  rvb     out = (struct coda_out_hdr *)vmp->vm_data;
    499   1.1  rvb     /* Don't need to copy opcode and uniquifier. */
    500   1.1  rvb 
    501   1.1  rvb     /* get the rest of the data. */
    502   1.1  rvb     if (vmp->vm_outSize < uiop->uio_resid) {
    503   1.1  rvb 	myprintf(("vcwrite: more data than asked for (%d < %d)\n",
    504   1.1  rvb 		  vmp->vm_outSize, uiop->uio_resid));
    505   1.1  rvb 	wakeup(&vmp->vm_sleep); 	/* Notify caller of the error. */
    506   1.1  rvb 	return(EINVAL);
    507   1.1  rvb     }
    508   1.1  rvb 
    509   1.1  rvb     buf[0] = uiop->uio_resid; 	/* Save this value. */
    510   1.1  rvb     uiop->uio_rw = UIO_WRITE;
    511   1.1  rvb     error = uiomove((caddr_t) &out->result, vmp->vm_outSize - (sizeof(int) * 2), uiop);
    512   1.1  rvb     if (error) {
    513   1.1  rvb 	myprintf(("vcwrite: error (%d) on uiomove (op %ld seq %ld)\n",
    514   1.1  rvb 		  error, opcode, seq));
    515   1.1  rvb 	return(EINVAL);
    516   1.1  rvb     }
    517   1.1  rvb 
    518   1.1  rvb     /* I don't think these are used, but just in case. */
    519   1.1  rvb     /* XXX - aren't these two already correct? -bnoble */
    520   1.1  rvb     out->opcode = opcode;
    521   1.1  rvb     out->unique = seq;
    522   1.1  rvb     vmp->vm_outSize	= buf[0];	/* Amount of data transferred? */
    523   1.1  rvb     vmp->vm_flags |= VM_WRITE;
    524   1.1  rvb     wakeup(&vmp->vm_sleep);
    525   1.1  rvb 
    526   1.1  rvb     return(0);
    527   1.1  rvb }
    528   1.1  rvb 
    529   1.5  rvb int
    530   1.1  rvb vc_nb_ioctl(dev, cmd, addr, flag, p)
    531   1.1  rvb     dev_t         dev;
    532   1.1  rvb     u_long        cmd;
    533   1.1  rvb     caddr_t       addr;
    534   1.1  rvb     int           flag;
    535   1.1  rvb     struct proc  *p;
    536   1.1  rvb {
    537   1.3  rvb     ENTRY;
    538   1.3  rvb 
    539   1.3  rvb     switch(cmd) {
    540   1.1  rvb     case CODARESIZE: {
    541   1.1  rvb 	struct coda_resize *data = (struct coda_resize *)addr;
    542   1.3  rvb 	return(coda_nc_resize(data->hashsize, data->heapsize, IS_DOWNCALL));
    543   1.3  rvb 	break;
    544   1.3  rvb     }
    545   1.1  rvb     case CODASTATS:
    546   1.1  rvb 	if (coda_nc_use) {
    547   1.1  rvb 	    coda_nc_gather_stats();
    548   1.1  rvb 	    return(0);
    549   1.1  rvb 	} else {
    550   1.3  rvb 	    return(ENODEV);
    551   1.3  rvb 	}
    552   1.3  rvb 	break;
    553   1.1  rvb     case CODAPRINT:
    554   1.1  rvb 	if (coda_nc_use) {
    555   1.1  rvb 	    print_coda_nc();
    556   1.1  rvb 	    return(0);
    557   1.1  rvb 	} else {
    558   1.9  rvb 	    return(ENODEV);
    559   1.9  rvb 	}
    560   1.9  rvb 	break;
    561   1.9  rvb     case CIOC_KERNEL_VERSION:
    562   1.9  rvb 	switch (*(u_int *)addr) {
    563   1.9  rvb 	case 0:
    564   1.9  rvb 		*(u_int *)addr = coda_kernel_version;
    565   1.9  rvb 		return 0;
    566   1.9  rvb 		break;
    567   1.9  rvb 	case 1:
    568   1.9  rvb 	case 2:
    569   1.9  rvb 		if (coda_kernel_version != *(u_int *)addr)
    570   1.9  rvb 		    return ENOENT;
    571   1.9  rvb 		else
    572   1.9  rvb 		    return 0;
    573   1.9  rvb 	default:
    574   1.1  rvb 		return ENOENT;
    575   1.1  rvb 	}
    576   1.1  rvb     	break;
    577   1.1  rvb     default :
    578   1.1  rvb 	return(EINVAL);
    579   1.1  rvb 	break;
    580   1.1  rvb     }
    581   1.1  rvb }
    582   1.1  rvb 
    583   1.1  rvb int
    584   1.1  rvb vc_nb_poll(dev, events, p)
    585   1.1  rvb     dev_t         dev;
    586   1.1  rvb     int           events;
    587   1.1  rvb     struct proc  *p;
    588   1.1  rvb {
    589   1.1  rvb     register struct vcomm *vcp;
    590   1.1  rvb     int event_msk = 0;
    591   1.3  rvb 
    592   1.1  rvb     ENTRY;
    593   1.1  rvb 
    594   1.3  rvb     if (minor(dev) >= NVCODA || minor(dev) < 0)
    595   1.1  rvb 	return(ENXIO);
    596   1.1  rvb 
    597   1.1  rvb     vcp = &coda_mnttbl[minor(dev)].mi_vcomm;
    598   1.1  rvb 
    599   1.1  rvb     event_msk = events & (POLLIN|POLLRDNORM);
    600   1.1  rvb     if (!event_msk)
    601   1.1  rvb 	return(0);
    602   1.1  rvb 
    603   1.1  rvb     if (!EMPTY(vcp->vc_requests))
    604   1.1  rvb 	return(events & (POLLIN|POLLRDNORM));
    605   1.1  rvb 
    606   1.1  rvb     selrecord(p, &(vcp->vc_selproc));
    607   1.1  rvb 
    608   1.1  rvb     return(0);
    609   1.1  rvb }
    610   1.1  rvb 
    611   1.3  rvb /*
    612   1.1  rvb  * Statistics
    613   1.1  rvb  */
    614   1.1  rvb struct coda_clstat coda_clstat;
    615   1.1  rvb 
    616   1.1  rvb /*
    617   1.1  rvb  * Key question: whether to sleep interuptably or uninteruptably when
    618   1.1  rvb  * waiting for Venus.  The former seems better (cause you can ^C a
    619   1.1  rvb  * job), but then GNU-EMACS completion breaks. Use tsleep with no
    620   1.1  rvb  * timeout, and no longjmp happens. But, when sleeping
    621   1.1  rvb  * "uninterruptibly", we don't get told if it returns abnormally
    622   1.1  rvb  * (e.g. kill -9).
    623   1.3  rvb  */
    624   1.3  rvb 
    625   1.1  rvb int
    626   1.1  rvb coda_call(mntinfo, inSize, outSize, buffer)
    627   1.1  rvb      struct coda_mntinfo *mntinfo; int inSize; int *outSize; caddr_t buffer;
    628   1.1  rvb {
    629   1.1  rvb 	struct vcomm *vcp;
    630   1.1  rvb 	struct vmsg *vmp;
    631   1.4  rvb 	int error;
    632   1.1  rvb #ifdef	CTL_C
    633   1.4  rvb 	struct proc *p = curproc;
    634   1.1  rvb 	sigset_t psig_omask;
    635   1.1  rvb 	int i;
    636   1.1  rvb 	psig_omask = p->p_siglist;	/* array assignment */
    637   1.1  rvb #endif
    638   1.1  rvb 	if (mntinfo == NULL) {
    639   1.1  rvb 	    /* Unlikely, but could be a race condition with a dying warden */
    640   1.1  rvb 	    return ENODEV;
    641   1.1  rvb 	}
    642   1.3  rvb 
    643   1.3  rvb 	vcp = &(mntinfo->mi_vcomm);
    644   1.1  rvb 
    645   1.1  rvb 	coda_clstat.ncalls++;
    646   1.1  rvb 	coda_clstat.reqs[((struct coda_in_hdr *)buffer)->opcode]++;
    647   1.1  rvb 
    648   1.3  rvb 	if (!VC_OPEN(vcp))
    649   1.1  rvb 	    return(ENODEV);
    650   1.1  rvb 
    651   1.1  rvb 	CODA_ALLOC(vmp,struct vmsg *,sizeof(struct vmsg));
    652   1.1  rvb 	/* Format the request message. */
    653   1.1  rvb 	vmp->vm_data = buffer;
    654   1.1  rvb 	vmp->vm_flags = 0;
    655   1.3  rvb 	vmp->vm_inSize = inSize;
    656   1.1  rvb 	vmp->vm_outSize
    657   1.3  rvb 	    = *outSize ? *outSize : inSize; /* |buffer| >= inSize */
    658   1.1  rvb 	vmp->vm_opcode = ((struct coda_in_hdr *)buffer)->opcode;
    659   1.1  rvb 	vmp->vm_unique = ++vcp->vc_seq;
    660   1.1  rvb 	if (codadebug)
    661   1.1  rvb 	    myprintf(("Doing a call for %d.%d\n",
    662   1.3  rvb 		      vmp->vm_opcode, vmp->vm_unique));
    663   1.1  rvb 
    664   1.1  rvb 	/* Fill in the common input args. */
    665   1.1  rvb 	((struct coda_in_hdr *)buffer)->unique = vmp->vm_unique;
    666   1.1  rvb 
    667   1.1  rvb 	/* Append msg to request queue and poke Venus. */
    668   1.1  rvb 	INSQUE(vmp->vm_chain, vcp->vc_requests);
    669   1.1  rvb 	selwakeup(&(vcp->vc_selproc));
    670   1.1  rvb 
    671   1.1  rvb 	/* We can be interrupted while we wait for Venus to process
    672   1.1  rvb 	 * our request.  If the interrupt occurs before Venus has read
    673   1.1  rvb 	 * the request, we dequeue and return. If it occurs after the
    674   1.1  rvb 	 * read but before the reply, we dequeue, send a signal
    675   1.1  rvb 	 * message, and return. If it occurs after the reply we ignore
    676   1.1  rvb 	 * it. In no case do we want to restart the syscall.  If it
    677   1.1  rvb 	 * was interrupted by a venus shutdown (vcclose), return
    678   1.1  rvb 	 * ENODEV.  */
    679   1.3  rvb 
    680   1.1  rvb 	/* Ignore return, We have to check anyway */
    681   1.1  rvb #ifdef	CTL_C
    682   1.1  rvb 	/* This is work in progress.  Setting coda_pcatch lets tsleep reawaken
    683   1.1  rvb 	   on a ^c or ^z.  The problem is that emacs sets certain interrupts
    684   1.1  rvb 	   as SA_RESTART.  This means that we should exit sleep handle the
    685   1.1  rvb 	   "signal" and then go to sleep again.  Mostly this is done by letting
    686   1.1  rvb 	   the syscall complete and be restarted.  We are not idempotent and
    687   1.1  rvb 	   can not do this.  A better solution is necessary.
    688   1.3  rvb 	 */
    689   1.1  rvb 	i = 0;
    690   1.1  rvb 	do {
    691   1.1  rvb 	    error = tsleep(&vmp->vm_sleep, (coda_call_sleep|coda_pcatch), "coda_call", hz*2);
    692   1.7  rvb 	    if (error == 0)
    693   1.3  rvb 	    	break;
    694   1.5  rvb 	    else if (error == EWOULDBLOCK) {
    695   1.4  rvb #ifdef	CODA_VERBOSE
    696   1.4  rvb 		    printf("coda_call: tsleep TIMEOUT %d sec\n", 2+2*i);
    697   1.7  rvb #endif
    698   1.3  rvb     	    } else if (sigismember(&p->p_siglist, SIGIO)) {
    699   1.5  rvb 		    sigaddset(&p->p_sigmask, SIGIO);
    700   1.8  rvb #ifdef	CODA_VERBOSE
    701   1.8  rvb 		    printf("coda_call: tsleep returns %d SIGIO, cnt %d\n", error, i);
    702   1.8  rvb #endif
    703   1.8  rvb     	    } else if (sigismember(&p->p_siglist, SIGALRM)) {
    704   1.8  rvb 		    sigaddset(&p->p_sigmask, SIGALRM);
    705   1.1  rvb #ifdef	CODA_VERBOSE
    706   1.4  rvb 		    printf("coda_call: tsleep returns %d SIGALRM, cnt %d\n", error, i);
    707   1.4  rvb #endif
    708   1.4  rvb 	    } else {
    709   1.4  rvb 		    sigset_t tmp;
    710   1.7  rvb 		    tmp = p->p_siglist;		/* array assignment */
    711   1.3  rvb 		    sigminusset(&p->p_sigmask, &tmp);
    712   1.4  rvb 
    713   1.4  rvb #ifdef	CODA_VERBOSE
    714   1.4  rvb 		    printf("coda_call: tsleep returns %d, cnt %d\n", error, i);
    715   1.4  rvb 		    printf("coda_call: siglist = %x.%x.%x.%x, sigmask = %x.%x.%x.%x, mask %x.%x.%x.%x\n",
    716   1.4  rvb 			    p->p_siglist.__bits[0], p->p_siglist.__bits[1],
    717   1.4  rvb 			    p->p_siglist.__bits[2], p->p_siglist.__bits[3],
    718   1.5  rvb 			    p->p_sigmask.__bits[0], p->p_sigmask.__bits[1],
    719   1.1  rvb 			    p->p_sigmask.__bits[2], p->p_sigmask.__bits[3],
    720   1.5  rvb 			    tmp.__bits[0], tmp.__bits[1], tmp.__bits[2], tmp.__bits[3]);
    721   1.4  rvb #endif
    722   1.4  rvb 		    break;
    723   1.4  rvb #ifdef	notyet
    724   1.4  rvb 		    sigminusset(&p->p_sigmask, &p->p_siglist);
    725   1.4  rvb 		    printf("coda_call: siglist = %x.%x.%x.%x, sigmask = %x.%x.%x.%x\n",
    726   1.4  rvb 			    p->p_siglist.__bits[0], p->p_siglist.__bits[1],
    727   1.5  rvb 			    p->p_siglist.__bits[2], p->p_siglist.__bits[3],
    728   1.1  rvb 			    p->p_sigmask.__bits[0], p->p_sigmask.__bits[1],
    729   1.8  rvb 			    p->p_sigmask.__bits[2], p->p_sigmask.__bits[3]);
    730   1.4  rvb #endif
    731   1.1  rvb 	    }
    732   1.3  rvb 	} while (error && i++ < 128 && VC_OPEN(vcp));
    733   1.1  rvb 	p->p_siglist = psig_omask;	/* array assignment */
    734   1.1  rvb #else
    735   1.1  rvb 	(void) tsleep(&vmp->vm_sleep, coda_call_sleep, "coda_call", 0);
    736   1.1  rvb #endif
    737   1.1  rvb 	if (VC_OPEN(vcp)) {	/* Venus is still alive */
    738   1.1  rvb  	/* Op went through, interrupt or not... */
    739   1.1  rvb 	    if (vmp->vm_flags & VM_WRITE) {
    740   1.1  rvb 		error = 0;
    741   1.1  rvb 		*outSize = vmp->vm_outSize;
    742   1.1  rvb 	    }
    743   1.7  rvb 
    744   1.7  rvb 	    else if (!(vmp->vm_flags & VM_READ)) {
    745   1.7  rvb 		/* Interrupted before venus read it. */
    746   1.5  rvb #ifdef	CODA_VERBOSE
    747   1.5  rvb 		if (1)
    748   1.1  rvb #else
    749   1.1  rvb 		if (codadebug)
    750   1.1  rvb #endif
    751   1.1  rvb 		    myprintf(("interrupted before read: op = %d.%d, flags = %x\n",
    752   1.1  rvb 			   vmp->vm_opcode, vmp->vm_unique, vmp->vm_flags));
    753   1.1  rvb 		REMQUE(vmp->vm_chain);
    754   1.1  rvb 		error = EINTR;
    755   1.1  rvb 	    }
    756   1.1  rvb 
    757   1.1  rvb 	    else {
    758   1.3  rvb 		/* (!(vmp->vm_flags & VM_WRITE)) means interrupted after
    759   1.1  rvb                    upcall started */
    760   1.1  rvb 		/* Interrupted after start of upcall, send venus a signal */
    761   1.7  rvb 		struct coda_in_hdr *dog;
    762   1.7  rvb 		struct vmsg *svmp;
    763   1.7  rvb 
    764   1.5  rvb #ifdef	CODA_VERBOSE
    765   1.5  rvb 		if (1)
    766   1.1  rvb #else
    767   1.1  rvb 		if (codadebug)
    768   1.1  rvb #endif
    769   1.1  rvb 		    myprintf(("Sending Venus a signal: op = %d.%d, flags = %x\n",
    770   1.1  rvb 			   vmp->vm_opcode, vmp->vm_unique, vmp->vm_flags));
    771   1.1  rvb 
    772   1.3  rvb 		REMQUE(vmp->vm_chain);
    773   1.1  rvb 		error = EINTR;
    774   1.3  rvb 
    775   1.3  rvb 		CODA_ALLOC(svmp, struct vmsg *, sizeof (struct vmsg));
    776   1.1  rvb 
    777   1.1  rvb 		CODA_ALLOC((svmp->vm_data), char *, sizeof (struct coda_in_hdr));
    778   1.3  rvb 		dog = (struct coda_in_hdr *)svmp->vm_data;
    779   1.1  rvb 
    780   1.3  rvb 		svmp->vm_flags = 0;
    781   1.3  rvb 		dog->opcode = svmp->vm_opcode = CODA_SIGNAL;
    782   1.1  rvb 		dog->unique = svmp->vm_unique = vmp->vm_unique;
    783   1.3  rvb 		svmp->vm_inSize = sizeof (struct coda_in_hdr);
    784   1.3  rvb /*??? rvb */	svmp->vm_outSize = sizeof (struct coda_in_hdr);
    785   1.1  rvb 
    786   1.1  rvb 		if (codadebug)
    787   1.1  rvb 		    myprintf(("coda_call: enqueing signal msg (%d, %d)\n",
    788   1.1  rvb 			   svmp->vm_opcode, svmp->vm_unique));
    789   1.1  rvb 
    790   1.1  rvb 		/* insert at head of queue! */
    791   1.1  rvb 		INSQUE(svmp->vm_chain, vcp->vc_requests);
    792   1.1  rvb 		selwakeup(&(vcp->vc_selproc));
    793   1.1  rvb 	    }
    794   1.3  rvb 	}
    795   1.1  rvb 
    796   1.1  rvb 	else {	/* If venus died (!VC_OPEN(vcp)) */
    797   1.1  rvb 	    if (codadebug)
    798   1.1  rvb 		myprintf(("vcclose woke op %d.%d flags %d\n",
    799   1.1  rvb 		       vmp->vm_opcode, vmp->vm_unique, vmp->vm_flags));
    800   1.1  rvb 
    801   1.3  rvb 		error = ENODEV;
    802   1.8  rvb 	}
    803   1.8  rvb 
    804   1.8  rvb 	CODA_FREE(vmp, sizeof(struct vmsg));
    805   1.1  rvb 
    806   1.1  rvb 	if (outstanding_upcalls > 0 && (--outstanding_upcalls == 0))
    807   1.3  rvb 		wakeup(&outstanding_upcalls);
    808   1.1  rvb 
    809   1.1  rvb 	if (!error)
    810   1.4  rvb 		error = ((struct coda_out_hdr *)buffer)->result;
    811            	return(error);
    812            }
    813            
    814