Home | History | Annotate | Line # | Download | only in kern
subr_devsw.c revision 1.20
      1  1.20       ad /*	$NetBSD: subr_devsw.c,v 1.20 2008/05/31 21:34:42 ad Exp $	*/
      2  1.11       ad 
      3   1.2  gehenna /*-
      4  1.20       ad  * Copyright (c) 2001, 2002, 2007, 2008 The NetBSD Foundation, Inc.
      5   1.2  gehenna  * All rights reserved.
      6   1.2  gehenna  *
      7   1.2  gehenna  * This code is derived from software contributed to The NetBSD Foundation
      8  1.11       ad  * by MAEKAWA Masahide <gehenna (at) NetBSD.org>, and by Andrew Doran.
      9   1.2  gehenna  *
     10   1.2  gehenna  * Redistribution and use in source and binary forms, with or without
     11   1.2  gehenna  * modification, are permitted provided that the following conditions
     12   1.2  gehenna  * are met:
     13   1.2  gehenna  * 1. Redistributions of source code must retain the above copyright
     14   1.2  gehenna  *    notice, this list of conditions and the following disclaimer.
     15   1.2  gehenna  * 2. Redistributions in binary form must reproduce the above copyright
     16   1.2  gehenna  *    notice, this list of conditions and the following disclaimer in the
     17   1.2  gehenna  *    documentation and/or other materials provided with the distribution.
     18   1.2  gehenna  *
     19   1.2  gehenna  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
     20   1.2  gehenna  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
     21   1.2  gehenna  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     22   1.2  gehenna  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
     23   1.2  gehenna  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     24   1.2  gehenna  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     25   1.2  gehenna  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
     26   1.2  gehenna  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
     27   1.2  gehenna  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     28   1.2  gehenna  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     29   1.2  gehenna  * POSSIBILITY OF SUCH DAMAGE.
     30   1.2  gehenna  */
     31  1.11       ad 
     32  1.11       ad /*
     33  1.11       ad  * Overview
     34  1.11       ad  *
     35  1.11       ad  *	subr_devsw.c: registers device drivers by name and by major
     36  1.11       ad  *	number, and provides wrapper methods for performing I/O and
     37  1.11       ad  *	other tasks on device drivers, keying on the device number
     38  1.11       ad  *	(dev_t).
     39  1.11       ad  *
     40  1.11       ad  *	When the system is built, the config(8) command generates
     41  1.11       ad  *	static tables of device drivers built into the kernel image
     42  1.11       ad  *	along with their associated methods.  These are recorded in
     43  1.11       ad  *	the cdevsw0 and bdevsw0 tables.  Drivers can also be added to
     44  1.11       ad  *	and removed from the system dynamically.
     45  1.11       ad  *
     46  1.11       ad  * Allocation
     47  1.11       ad  *
     48  1.11       ad  *	When the system initially boots only the statically allocated
     49  1.11       ad  *	indexes (bdevsw0, cdevsw0) are used.  If these overflow due to
     50  1.11       ad  *	allocation, we allocate a fixed block of memory to hold the new,
     51  1.11       ad  *	expanded index.  This "fork" of the table is only ever performed
     52  1.11       ad  *	once in order to guarantee that other threads may safely access
     53  1.11       ad  *	the device tables:
     54  1.11       ad  *
     55  1.11       ad  *	o Once a thread has a "reference" to the table via an earlier
     56  1.11       ad  *	  open() call, we know that the entry in the table must exist
     57  1.11       ad  *	  and so it is safe to access it.
     58  1.11       ad  *
     59  1.11       ad  *	o Regardless of whether other threads see the old or new
     60  1.11       ad  *	  pointers, they will point to a correct device switch
     61  1.11       ad  *	  structure for the operation being performed.
     62  1.11       ad  *
     63  1.11       ad  *	XXX Currently, the wrapper methods such as cdev_read() verify
     64  1.11       ad  *	that a device driver does in fact exist before calling the
     65  1.11       ad  *	associated driver method.  This should be changed so that
     66  1.11       ad  *	once the device is has been referenced by a vnode (opened),
     67  1.11       ad  *	calling	the other methods should be valid until that reference
     68  1.11       ad  *	is dropped.
     69  1.11       ad  */
     70   1.7    lukem 
     71   1.7    lukem #include <sys/cdefs.h>
     72  1.20       ad __KERNEL_RCSID(0, "$NetBSD: subr_devsw.c,v 1.20 2008/05/31 21:34:42 ad Exp $");
     73   1.2  gehenna 
     74   1.2  gehenna #include <sys/param.h>
     75   1.2  gehenna #include <sys/conf.h>
     76  1.11       ad #include <sys/kmem.h>
     77   1.2  gehenna #include <sys/systm.h>
     78  1.11       ad #include <sys/poll.h>
     79  1.11       ad #include <sys/tty.h>
     80  1.15     matt #include <sys/cpu.h>
     81  1.11       ad #include <sys/buf.h>
     82   1.2  gehenna 
     83  1.20       ad #include <miscfs/specfs/specdev.h>
     84  1.20       ad 
     85   1.2  gehenna #ifdef DEVSW_DEBUG
     86   1.2  gehenna #define	DPRINTF(x)	printf x
     87   1.2  gehenna #else /* DEVSW_DEBUG */
     88   1.2  gehenna #define	DPRINTF(x)
     89   1.2  gehenna #endif /* DEVSW_DEBUG */
     90   1.2  gehenna 
     91  1.11       ad #define	MAXDEVSW	512	/* the maximum of major device number */
     92   1.2  gehenna #define	BDEVSW_SIZE	(sizeof(struct bdevsw *))
     93   1.2  gehenna #define	CDEVSW_SIZE	(sizeof(struct cdevsw *))
     94   1.2  gehenna #define	DEVSWCONV_SIZE	(sizeof(struct devsw_conv))
     95   1.2  gehenna 
     96   1.2  gehenna extern const struct bdevsw **bdevsw, *bdevsw0[];
     97   1.2  gehenna extern const struct cdevsw **cdevsw, *cdevsw0[];
     98   1.2  gehenna extern struct devsw_conv *devsw_conv, devsw_conv0[];
     99   1.2  gehenna extern const int sys_bdevsws, sys_cdevsws;
    100   1.2  gehenna extern int max_bdevsws, max_cdevsws, max_devsw_convs;
    101   1.2  gehenna 
    102  1.14    pooka static int bdevsw_attach(const struct bdevsw *, int *);
    103  1.14    pooka static int cdevsw_attach(const struct cdevsw *, int *);
    104  1.11       ad static void devsw_detach_locked(const struct bdevsw *, const struct cdevsw *);
    105  1.11       ad 
    106  1.11       ad void
    107  1.11       ad devsw_init(void)
    108  1.11       ad {
    109  1.11       ad 
    110  1.11       ad 	KASSERT(sys_bdevsws < MAXDEVSW - 1);
    111  1.11       ad 	KASSERT(sys_cdevsws < MAXDEVSW - 1);
    112  1.11       ad }
    113   1.2  gehenna 
    114   1.2  gehenna int
    115   1.2  gehenna devsw_attach(const char *devname, const struct bdevsw *bdev, int *bmajor,
    116   1.2  gehenna 	     const struct cdevsw *cdev, int *cmajor)
    117   1.2  gehenna {
    118   1.2  gehenna 	struct devsw_conv *conv;
    119   1.2  gehenna 	char *name;
    120   1.2  gehenna 	int error, i;
    121   1.2  gehenna 
    122   1.2  gehenna 	if (devname == NULL || cdev == NULL)
    123   1.2  gehenna 		return (EINVAL);
    124   1.2  gehenna 
    125  1.20       ad 	mutex_enter(&specfs_lock);
    126  1.11       ad 
    127   1.2  gehenna 	for (i = 0 ; i < max_devsw_convs ; i++) {
    128   1.2  gehenna 		conv = &devsw_conv[i];
    129   1.2  gehenna 		if (conv->d_name == NULL || strcmp(devname, conv->d_name) != 0)
    130   1.2  gehenna 			continue;
    131   1.2  gehenna 
    132   1.2  gehenna 		if (*bmajor < 0)
    133   1.2  gehenna 			*bmajor = conv->d_bmajor;
    134   1.2  gehenna 		if (*cmajor < 0)
    135   1.2  gehenna 			*cmajor = conv->d_cmajor;
    136   1.2  gehenna 
    137  1.11       ad 		if (*bmajor != conv->d_bmajor || *cmajor != conv->d_cmajor) {
    138  1.11       ad 			error = EINVAL;
    139  1.11       ad 			goto fail;
    140  1.11       ad 		}
    141  1.11       ad 		if ((*bmajor >= 0 && bdev == NULL) || *cmajor < 0) {
    142  1.11       ad 			error = EINVAL;
    143  1.11       ad 			goto fail;
    144  1.11       ad 		}
    145   1.2  gehenna 
    146   1.2  gehenna 		if ((*bmajor >= 0 && bdevsw[*bmajor] != NULL) ||
    147  1.11       ad 		    cdevsw[*cmajor] != NULL) {
    148  1.11       ad 			error = EEXIST;
    149  1.11       ad 			goto fail;
    150  1.11       ad 		}
    151   1.2  gehenna 
    152   1.2  gehenna 		if (bdev != NULL)
    153   1.2  gehenna 			bdevsw[*bmajor] = bdev;
    154   1.2  gehenna 		cdevsw[*cmajor] = cdev;
    155   1.2  gehenna 
    156  1.20       ad 		mutex_exit(&specfs_lock);
    157   1.2  gehenna 		return (0);
    158   1.2  gehenna 	}
    159   1.2  gehenna 
    160  1.14    pooka 	error = bdevsw_attach(bdev, bmajor);
    161  1.11       ad 	if (error != 0)
    162  1.11       ad 		goto fail;
    163  1.14    pooka 	error = cdevsw_attach(cdev, cmajor);
    164   1.2  gehenna 	if (error != 0) {
    165  1.11       ad 		devsw_detach_locked(bdev, NULL);
    166  1.11       ad 		goto fail;
    167   1.2  gehenna 	}
    168   1.2  gehenna 
    169   1.2  gehenna 	for (i = 0 ; i < max_devsw_convs ; i++) {
    170   1.2  gehenna 		if (devsw_conv[i].d_name == NULL)
    171   1.2  gehenna 			break;
    172   1.2  gehenna 	}
    173   1.2  gehenna 	if (i == max_devsw_convs) {
    174   1.2  gehenna 		struct devsw_conv *newptr;
    175   1.2  gehenna 		int old, new;
    176   1.2  gehenna 
    177   1.2  gehenna 		old = max_devsw_convs;
    178   1.2  gehenna 		new = old + 1;
    179   1.2  gehenna 
    180  1.11       ad 		newptr = kmem_zalloc(new * DEVSWCONV_SIZE, KM_NOSLEEP);
    181   1.2  gehenna 		if (newptr == NULL) {
    182  1.11       ad 			devsw_detach_locked(bdev, cdev);
    183  1.11       ad 			error = ENOMEM;
    184  1.11       ad 			goto fail;
    185   1.2  gehenna 		}
    186   1.2  gehenna 		newptr[old].d_name = NULL;
    187   1.2  gehenna 		newptr[old].d_bmajor = -1;
    188   1.2  gehenna 		newptr[old].d_cmajor = -1;
    189   1.2  gehenna 		memcpy(newptr, devsw_conv, old * DEVSWCONV_SIZE);
    190   1.2  gehenna 		if (devsw_conv != devsw_conv0)
    191  1.11       ad 			kmem_free(devsw_conv, old * DEVSWCONV_SIZE);
    192   1.2  gehenna 		devsw_conv = newptr;
    193   1.2  gehenna 		max_devsw_convs = new;
    194   1.2  gehenna 	}
    195   1.2  gehenna 
    196   1.6   itojun 	i = strlen(devname) + 1;
    197  1.11       ad 	name = kmem_alloc(i, KM_NOSLEEP);
    198   1.2  gehenna 	if (name == NULL) {
    199  1.11       ad 		devsw_detach_locked(bdev, cdev);
    200  1.11       ad 		goto fail;
    201   1.2  gehenna 	}
    202   1.6   itojun 	strlcpy(name, devname, i);
    203   1.2  gehenna 
    204   1.2  gehenna 	devsw_conv[i].d_name = name;
    205   1.2  gehenna 	devsw_conv[i].d_bmajor = *bmajor;
    206   1.2  gehenna 	devsw_conv[i].d_cmajor = *cmajor;
    207   1.2  gehenna 
    208  1.20       ad 	mutex_exit(&specfs_lock);
    209   1.2  gehenna 	return (0);
    210  1.11       ad  fail:
    211  1.20       ad 	mutex_exit(&specfs_lock);
    212  1.11       ad 	return (error);
    213   1.2  gehenna }
    214   1.2  gehenna 
    215   1.2  gehenna static int
    216  1.14    pooka bdevsw_attach(const struct bdevsw *devsw, int *devmajor)
    217   1.2  gehenna {
    218  1.11       ad 	const struct bdevsw **newptr;
    219   1.2  gehenna 	int bmajor, i;
    220   1.2  gehenna 
    221  1.20       ad 	KASSERT(mutex_owned(&specfs_lock));
    222  1.11       ad 
    223   1.2  gehenna 	if (devsw == NULL)
    224   1.2  gehenna 		return (0);
    225   1.2  gehenna 
    226   1.2  gehenna 	if (*devmajor < 0) {
    227   1.2  gehenna 		for (bmajor = sys_bdevsws ; bmajor < max_bdevsws ; bmajor++) {
    228   1.2  gehenna 			if (bdevsw[bmajor] != NULL)
    229   1.2  gehenna 				continue;
    230   1.2  gehenna 			for (i = 0 ; i < max_devsw_convs ; i++) {
    231   1.2  gehenna 				if (devsw_conv[i].d_bmajor == bmajor)
    232   1.2  gehenna 					break;
    233   1.2  gehenna 			}
    234   1.2  gehenna 			if (i != max_devsw_convs)
    235   1.2  gehenna 				continue;
    236   1.2  gehenna 			break;
    237   1.2  gehenna 		}
    238   1.3  gehenna 		*devmajor = bmajor;
    239   1.2  gehenna 	}
    240  1.11       ad 
    241   1.2  gehenna 	if (*devmajor >= MAXDEVSW) {
    242  1.11       ad 		printf("bdevsw_attach: block majors exhausted");
    243   1.2  gehenna 		return (ENOMEM);
    244   1.2  gehenna 	}
    245   1.2  gehenna 
    246   1.2  gehenna 	if (*devmajor >= max_bdevsws) {
    247  1.11       ad 		KASSERT(bdevsw == bdevsw0);
    248  1.11       ad 		newptr = kmem_zalloc(MAXDEVSW * BDEVSW_SIZE, KM_NOSLEEP);
    249   1.2  gehenna 		if (newptr == NULL)
    250   1.2  gehenna 			return (ENOMEM);
    251  1.11       ad 		memcpy(newptr, bdevsw, max_bdevsws * BDEVSW_SIZE);
    252   1.2  gehenna 		bdevsw = newptr;
    253  1.11       ad 		max_bdevsws = MAXDEVSW;
    254   1.2  gehenna 	}
    255   1.2  gehenna 
    256   1.2  gehenna 	if (bdevsw[*devmajor] != NULL)
    257   1.2  gehenna 		return (EEXIST);
    258   1.2  gehenna 
    259   1.2  gehenna 	bdevsw[*devmajor] = devsw;
    260   1.2  gehenna 
    261   1.2  gehenna 	return (0);
    262   1.2  gehenna }
    263   1.2  gehenna 
    264   1.2  gehenna static int
    265  1.14    pooka cdevsw_attach(const struct cdevsw *devsw, int *devmajor)
    266   1.2  gehenna {
    267  1.11       ad 	const struct cdevsw **newptr;
    268   1.2  gehenna 	int cmajor, i;
    269   1.2  gehenna 
    270  1.20       ad 	KASSERT(mutex_owned(&specfs_lock));
    271  1.11       ad 
    272   1.2  gehenna 	if (*devmajor < 0) {
    273   1.2  gehenna 		for (cmajor = sys_cdevsws ; cmajor < max_cdevsws ; cmajor++) {
    274   1.2  gehenna 			if (cdevsw[cmajor] != NULL)
    275   1.2  gehenna 				continue;
    276   1.2  gehenna 			for (i = 0 ; i < max_devsw_convs ; i++) {
    277   1.2  gehenna 				if (devsw_conv[i].d_cmajor == cmajor)
    278   1.2  gehenna 					break;
    279   1.2  gehenna 			}
    280   1.2  gehenna 			if (i != max_devsw_convs)
    281   1.2  gehenna 				continue;
    282   1.2  gehenna 			break;
    283   1.2  gehenna 		}
    284   1.3  gehenna 		*devmajor = cmajor;
    285   1.2  gehenna 	}
    286  1.11       ad 
    287   1.2  gehenna 	if (*devmajor >= MAXDEVSW) {
    288  1.11       ad 		printf("cdevsw_attach: character majors exhausted");
    289   1.2  gehenna 		return (ENOMEM);
    290   1.2  gehenna 	}
    291   1.2  gehenna 
    292   1.2  gehenna 	if (*devmajor >= max_cdevsws) {
    293  1.11       ad 		KASSERT(cdevsw == cdevsw0);
    294  1.11       ad 		newptr = kmem_zalloc(MAXDEVSW * CDEVSW_SIZE, KM_NOSLEEP);
    295   1.2  gehenna 		if (newptr == NULL)
    296   1.2  gehenna 			return (ENOMEM);
    297  1.11       ad 		memcpy(newptr, cdevsw, max_cdevsws * CDEVSW_SIZE);
    298   1.2  gehenna 		cdevsw = newptr;
    299  1.11       ad 		max_cdevsws = MAXDEVSW;
    300   1.2  gehenna 	}
    301   1.2  gehenna 
    302   1.2  gehenna 	if (cdevsw[*devmajor] != NULL)
    303   1.2  gehenna 		return (EEXIST);
    304   1.2  gehenna 
    305   1.2  gehenna 	cdevsw[*devmajor] = devsw;
    306   1.2  gehenna 
    307   1.2  gehenna 	return (0);
    308   1.2  gehenna }
    309   1.2  gehenna 
    310  1.11       ad static void
    311  1.11       ad devsw_detach_locked(const struct bdevsw *bdev, const struct cdevsw *cdev)
    312   1.2  gehenna {
    313   1.2  gehenna 	int i;
    314   1.2  gehenna 
    315  1.20       ad 	KASSERT(mutex_owned(&specfs_lock));
    316  1.11       ad 
    317   1.2  gehenna 	if (bdev != NULL) {
    318   1.2  gehenna 		for (i = 0 ; i < max_bdevsws ; i++) {
    319   1.2  gehenna 			if (bdevsw[i] != bdev)
    320   1.2  gehenna 				continue;
    321   1.2  gehenna 			bdevsw[i] = NULL;
    322   1.2  gehenna 			break;
    323   1.2  gehenna 		}
    324   1.2  gehenna 	}
    325   1.2  gehenna 	if (cdev != NULL) {
    326   1.2  gehenna 		for (i = 0 ; i < max_cdevsws ; i++) {
    327   1.2  gehenna 			if (cdevsw[i] != cdev)
    328   1.2  gehenna 				continue;
    329   1.2  gehenna 			cdevsw[i] = NULL;
    330   1.2  gehenna 			break;
    331   1.2  gehenna 		}
    332   1.2  gehenna 	}
    333   1.2  gehenna }
    334   1.2  gehenna 
    335  1.19       ad int
    336  1.11       ad devsw_detach(const struct bdevsw *bdev, const struct cdevsw *cdev)
    337  1.11       ad {
    338  1.11       ad 
    339  1.20       ad 	mutex_enter(&specfs_lock);
    340  1.11       ad 	devsw_detach_locked(bdev, cdev);
    341  1.20       ad 	mutex_exit(&specfs_lock);
    342  1.19       ad 	return 0;
    343  1.11       ad }
    344  1.11       ad 
    345  1.11       ad /*
    346  1.11       ad  * Look up a block device by number.
    347  1.11       ad  *
    348  1.11       ad  * => Caller must ensure that the device is attached.
    349  1.11       ad  */
    350   1.2  gehenna const struct bdevsw *
    351   1.2  gehenna bdevsw_lookup(dev_t dev)
    352   1.2  gehenna {
    353   1.2  gehenna 	int bmajor;
    354   1.2  gehenna 
    355   1.2  gehenna 	if (dev == NODEV)
    356   1.2  gehenna 		return (NULL);
    357   1.2  gehenna 	bmajor = major(dev);
    358   1.2  gehenna 	if (bmajor < 0 || bmajor >= max_bdevsws)
    359   1.2  gehenna 		return (NULL);
    360   1.2  gehenna 
    361   1.2  gehenna 	return (bdevsw[bmajor]);
    362   1.2  gehenna }
    363   1.2  gehenna 
    364  1.11       ad /*
    365  1.11       ad  * Look up a character device by number.
    366  1.11       ad  *
    367  1.11       ad  * => Caller must ensure that the device is attached.
    368  1.11       ad  */
    369   1.2  gehenna const struct cdevsw *
    370   1.2  gehenna cdevsw_lookup(dev_t dev)
    371   1.2  gehenna {
    372   1.2  gehenna 	int cmajor;
    373   1.2  gehenna 
    374   1.2  gehenna 	if (dev == NODEV)
    375   1.2  gehenna 		return (NULL);
    376   1.2  gehenna 	cmajor = major(dev);
    377   1.2  gehenna 	if (cmajor < 0 || cmajor >= max_cdevsws)
    378   1.2  gehenna 		return (NULL);
    379   1.2  gehenna 
    380   1.2  gehenna 	return (cdevsw[cmajor]);
    381   1.2  gehenna }
    382   1.2  gehenna 
    383  1.11       ad /*
    384  1.11       ad  * Look up a block device by reference to its operations set.
    385  1.11       ad  *
    386  1.11       ad  * => Caller must ensure that the device is not detached, and therefore
    387  1.11       ad  *    that the returned major is still valid when dereferenced.
    388  1.11       ad  */
    389   1.2  gehenna int
    390   1.2  gehenna bdevsw_lookup_major(const struct bdevsw *bdev)
    391   1.2  gehenna {
    392   1.2  gehenna 	int bmajor;
    393   1.2  gehenna 
    394   1.2  gehenna 	for (bmajor = 0 ; bmajor < max_bdevsws ; bmajor++) {
    395   1.2  gehenna 		if (bdevsw[bmajor] == bdev)
    396   1.2  gehenna 			return (bmajor);
    397   1.2  gehenna 	}
    398   1.2  gehenna 
    399   1.2  gehenna 	return (-1);
    400   1.2  gehenna }
    401   1.2  gehenna 
    402  1.11       ad /*
    403  1.11       ad  * Look up a character device by reference to its operations set.
    404  1.11       ad  *
    405  1.11       ad  * => Caller must ensure that the device is not detached, and therefore
    406  1.11       ad  *    that the returned major is still valid when dereferenced.
    407  1.11       ad  */
    408   1.2  gehenna int
    409   1.2  gehenna cdevsw_lookup_major(const struct cdevsw *cdev)
    410   1.2  gehenna {
    411   1.2  gehenna 	int cmajor;
    412   1.2  gehenna 
    413   1.2  gehenna 	for (cmajor = 0 ; cmajor < max_cdevsws ; cmajor++) {
    414   1.2  gehenna 		if (cdevsw[cmajor] == cdev)
    415   1.2  gehenna 			return (cmajor);
    416   1.2  gehenna 	}
    417   1.2  gehenna 
    418   1.2  gehenna 	return (-1);
    419   1.2  gehenna }
    420   1.2  gehenna 
    421   1.2  gehenna /*
    422   1.2  gehenna  * Convert from block major number to name.
    423  1.11       ad  *
    424  1.11       ad  * => Caller must ensure that the device is not detached, and therefore
    425  1.11       ad  *    that the name pointer is still valid when dereferenced.
    426   1.2  gehenna  */
    427   1.2  gehenna const char *
    428   1.2  gehenna devsw_blk2name(int bmajor)
    429   1.2  gehenna {
    430  1.11       ad 	const char *name;
    431   1.2  gehenna 	int cmajor, i;
    432   1.2  gehenna 
    433  1.11       ad 	name = NULL;
    434  1.11       ad 	cmajor = -1;
    435  1.11       ad 
    436  1.20       ad 	mutex_enter(&specfs_lock);
    437  1.11       ad 	if (bmajor < 0 || bmajor >= max_bdevsws || bdevsw[bmajor] == NULL) {
    438  1.20       ad 		mutex_exit(&specfs_lock);
    439   1.2  gehenna 		return (NULL);
    440   1.2  gehenna 	}
    441  1.11       ad 	for (i = 0 ; i < max_devsw_convs; i++) {
    442  1.11       ad 		if (devsw_conv[i].d_bmajor == bmajor) {
    443  1.11       ad 			cmajor = devsw_conv[i].d_cmajor;
    444  1.11       ad 			break;
    445  1.11       ad 		}
    446  1.11       ad 	}
    447  1.11       ad 	if (cmajor >= 0 && cmajor < max_cdevsws && cdevsw[cmajor] != NULL)
    448  1.11       ad 		name = devsw_conv[i].d_name;
    449  1.20       ad 	mutex_exit(&specfs_lock);
    450   1.2  gehenna 
    451  1.11       ad 	return (name);
    452   1.2  gehenna }
    453   1.2  gehenna 
    454   1.2  gehenna /*
    455   1.2  gehenna  * Convert from device name to block major number.
    456  1.11       ad  *
    457  1.11       ad  * => Caller must ensure that the device is not detached, and therefore
    458  1.11       ad  *    that the major number is still valid when dereferenced.
    459   1.2  gehenna  */
    460   1.2  gehenna int
    461   1.2  gehenna devsw_name2blk(const char *name, char *devname, size_t devnamelen)
    462   1.2  gehenna {
    463   1.2  gehenna 	struct devsw_conv *conv;
    464   1.2  gehenna 	int bmajor, i;
    465   1.2  gehenna 
    466   1.2  gehenna 	if (name == NULL)
    467   1.2  gehenna 		return (-1);
    468   1.2  gehenna 
    469  1.20       ad 	mutex_enter(&specfs_lock);
    470   1.2  gehenna 	for (i = 0 ; i < max_devsw_convs ; i++) {
    471   1.5      mrg 		size_t len;
    472   1.5      mrg 
    473   1.2  gehenna 		conv = &devsw_conv[i];
    474   1.2  gehenna 		if (conv->d_name == NULL)
    475   1.2  gehenna 			continue;
    476   1.5      mrg 		len = strlen(conv->d_name);
    477   1.5      mrg 		if (strncmp(conv->d_name, name, len) != 0)
    478   1.5      mrg 			continue;
    479   1.5      mrg 		if (*(name +len) && !isdigit(*(name + len)))
    480   1.2  gehenna 			continue;
    481   1.2  gehenna 		bmajor = conv->d_bmajor;
    482   1.2  gehenna 		if (bmajor < 0 || bmajor >= max_bdevsws ||
    483   1.2  gehenna 		    bdevsw[bmajor] == NULL)
    484   1.5      mrg 			break;
    485   1.2  gehenna 		if (devname != NULL) {
    486   1.2  gehenna #ifdef DEVSW_DEBUG
    487   1.2  gehenna 			if (strlen(conv->d_name) >= devnamelen)
    488   1.2  gehenna 				printf("devsw_name2blk: too short buffer");
    489   1.2  gehenna #endif /* DEVSW_DEBUG */
    490   1.4  tsutsui 			strncpy(devname, conv->d_name, devnamelen);
    491   1.2  gehenna 			devname[devnamelen - 1] = '\0';
    492   1.2  gehenna 		}
    493  1.20       ad 		mutex_exit(&specfs_lock);
    494   1.2  gehenna 		return (bmajor);
    495   1.2  gehenna 	}
    496   1.2  gehenna 
    497  1.20       ad 	mutex_exit(&specfs_lock);
    498   1.2  gehenna 	return (-1);
    499   1.2  gehenna }
    500   1.2  gehenna 
    501   1.2  gehenna /*
    502  1.16   plunky  * Convert from device name to char major number.
    503  1.16   plunky  *
    504  1.16   plunky  * => Caller must ensure that the device is not detached, and therefore
    505  1.16   plunky  *    that the major number is still valid when dereferenced.
    506  1.16   plunky  */
    507  1.16   plunky int
    508  1.16   plunky devsw_name2chr(const char *name, char *devname, size_t devnamelen)
    509  1.16   plunky {
    510  1.16   plunky 	struct devsw_conv *conv;
    511  1.16   plunky 	int cmajor, i;
    512  1.16   plunky 
    513  1.16   plunky 	if (name == NULL)
    514  1.16   plunky 		return (-1);
    515  1.16   plunky 
    516  1.20       ad 	mutex_enter(&specfs_lock);
    517  1.16   plunky 	for (i = 0 ; i < max_devsw_convs ; i++) {
    518  1.16   plunky 		size_t len;
    519  1.16   plunky 
    520  1.16   plunky 		conv = &devsw_conv[i];
    521  1.16   plunky 		if (conv->d_name == NULL)
    522  1.16   plunky 			continue;
    523  1.16   plunky 		len = strlen(conv->d_name);
    524  1.16   plunky 		if (strncmp(conv->d_name, name, len) != 0)
    525  1.16   plunky 			continue;
    526  1.16   plunky 		if (*(name +len) && !isdigit(*(name + len)))
    527  1.16   plunky 			continue;
    528  1.16   plunky 		cmajor = conv->d_cmajor;
    529  1.16   plunky 		if (cmajor < 0 || cmajor >= max_cdevsws ||
    530  1.16   plunky 		    cdevsw[cmajor] == NULL)
    531  1.16   plunky 			break;
    532  1.16   plunky 		if (devname != NULL) {
    533  1.16   plunky #ifdef DEVSW_DEBUG
    534  1.16   plunky 			if (strlen(conv->d_name) >= devnamelen)
    535  1.16   plunky 				printf("devsw_name2chr: too short buffer");
    536  1.16   plunky #endif /* DEVSW_DEBUG */
    537  1.16   plunky 			strncpy(devname, conv->d_name, devnamelen);
    538  1.16   plunky 			devname[devnamelen - 1] = '\0';
    539  1.16   plunky 		}
    540  1.20       ad 		mutex_exit(&specfs_lock);
    541  1.16   plunky 		return (cmajor);
    542  1.16   plunky 	}
    543  1.16   plunky 
    544  1.20       ad 	mutex_exit(&specfs_lock);
    545  1.16   plunky 	return (-1);
    546  1.16   plunky }
    547  1.16   plunky 
    548  1.16   plunky /*
    549   1.2  gehenna  * Convert from character dev_t to block dev_t.
    550  1.11       ad  *
    551  1.11       ad  * => Caller must ensure that the device is not detached, and therefore
    552  1.11       ad  *    that the major number is still valid when dereferenced.
    553   1.2  gehenna  */
    554   1.2  gehenna dev_t
    555   1.2  gehenna devsw_chr2blk(dev_t cdev)
    556   1.2  gehenna {
    557   1.2  gehenna 	int bmajor, cmajor, i;
    558  1.11       ad 	dev_t rv;
    559   1.2  gehenna 
    560   1.2  gehenna 	cmajor = major(cdev);
    561  1.11       ad 	bmajor = -1;
    562  1.11       ad 	rv = NODEV;
    563   1.2  gehenna 
    564  1.20       ad 	mutex_enter(&specfs_lock);
    565  1.11       ad 	if (cmajor < 0 || cmajor >= max_cdevsws || cdevsw[cmajor] == NULL) {
    566  1.20       ad 		mutex_exit(&specfs_lock);
    567  1.11       ad 		return (NODEV);
    568  1.11       ad 	}
    569   1.2  gehenna 	for (i = 0 ; i < max_devsw_convs ; i++) {
    570  1.11       ad 		if (devsw_conv[i].d_cmajor == cmajor) {
    571  1.11       ad 			bmajor = devsw_conv[i].d_bmajor;
    572  1.11       ad 			break;
    573  1.11       ad 		}
    574   1.2  gehenna 	}
    575  1.11       ad 	if (bmajor >= 0 && bmajor < max_bdevsws && bdevsw[bmajor] != NULL)
    576  1.11       ad 		rv = makedev(bmajor, minor(cdev));
    577  1.20       ad 	mutex_exit(&specfs_lock);
    578   1.2  gehenna 
    579  1.11       ad 	return (rv);
    580   1.2  gehenna }
    581   1.2  gehenna 
    582   1.2  gehenna /*
    583   1.2  gehenna  * Convert from block dev_t to character dev_t.
    584  1.11       ad  *
    585  1.11       ad  * => Caller must ensure that the device is not detached, and therefore
    586  1.11       ad  *    that the major number is still valid when dereferenced.
    587   1.2  gehenna  */
    588   1.2  gehenna dev_t
    589   1.2  gehenna devsw_blk2chr(dev_t bdev)
    590   1.2  gehenna {
    591   1.2  gehenna 	int bmajor, cmajor, i;
    592  1.11       ad 	dev_t rv;
    593   1.2  gehenna 
    594  1.11       ad 	bmajor = major(bdev);
    595  1.11       ad 	cmajor = -1;
    596  1.11       ad 	rv = NODEV;
    597  1.11       ad 
    598  1.20       ad 	mutex_enter(&specfs_lock);
    599  1.11       ad 	if (bmajor < 0 || bmajor >= max_bdevsws || bdevsw[bmajor] == NULL) {
    600  1.20       ad 		mutex_exit(&specfs_lock);
    601   1.2  gehenna 		return (NODEV);
    602  1.11       ad 	}
    603  1.11       ad 	for (i = 0 ; i < max_devsw_convs ; i++) {
    604  1.11       ad 		if (devsw_conv[i].d_bmajor == bmajor) {
    605  1.11       ad 			cmajor = devsw_conv[i].d_cmajor;
    606  1.11       ad 			break;
    607  1.11       ad 		}
    608  1.11       ad 	}
    609  1.11       ad 	if (cmajor >= 0 && cmajor < max_cdevsws && cdevsw[cmajor] != NULL)
    610  1.11       ad 		rv = makedev(cmajor, minor(bdev));
    611  1.20       ad 	mutex_exit(&specfs_lock);
    612   1.2  gehenna 
    613  1.11       ad 	return (rv);
    614  1.11       ad }
    615  1.11       ad 
    616  1.11       ad /*
    617  1.11       ad  * Device access methods.
    618  1.11       ad  */
    619  1.11       ad 
    620  1.11       ad #define	DEV_LOCK(d)						\
    621  1.17       ad 	if ((mpflag = (d->d_flag & D_MPSAFE)) == 0) {		\
    622  1.17       ad 		KERNEL_LOCK(1, NULL);				\
    623  1.11       ad 	}
    624   1.2  gehenna 
    625  1.11       ad #define	DEV_UNLOCK(d)						\
    626  1.17       ad 	if (mpflag == 0) {					\
    627  1.17       ad 		KERNEL_UNLOCK_ONE(NULL);			\
    628   1.2  gehenna 	}
    629   1.2  gehenna 
    630  1.11       ad int
    631  1.11       ad bdev_open(dev_t dev, int flag, int devtype, lwp_t *l)
    632  1.11       ad {
    633  1.11       ad 	const struct bdevsw *d;
    634  1.17       ad 	int rv, mpflag;
    635  1.11       ad 
    636  1.11       ad 	/*
    637  1.11       ad 	 * For open we need to lock, in order to synchronize
    638  1.11       ad 	 * with attach/detach.
    639  1.11       ad 	 */
    640  1.20       ad 	mutex_enter(&specfs_lock);
    641  1.11       ad 	d = bdevsw_lookup(dev);
    642  1.20       ad 	mutex_exit(&specfs_lock);
    643  1.11       ad 	if (d == NULL)
    644  1.11       ad 		return ENXIO;
    645  1.11       ad 
    646  1.11       ad 	DEV_LOCK(d);
    647  1.11       ad 	rv = (*d->d_open)(dev, flag, devtype, l);
    648  1.11       ad 	DEV_UNLOCK(d);
    649  1.11       ad 
    650  1.11       ad 	return rv;
    651  1.11       ad }
    652  1.11       ad 
    653  1.11       ad int
    654  1.11       ad bdev_close(dev_t dev, int flag, int devtype, lwp_t *l)
    655  1.11       ad {
    656  1.11       ad 	const struct bdevsw *d;
    657  1.17       ad 	int rv, mpflag;
    658  1.11       ad 
    659  1.11       ad 	if ((d = bdevsw_lookup(dev)) == NULL)
    660  1.11       ad 		return ENXIO;
    661  1.11       ad 
    662  1.11       ad 	DEV_LOCK(d);
    663  1.11       ad 	rv = (*d->d_close)(dev, flag, devtype, l);
    664  1.11       ad 	DEV_UNLOCK(d);
    665  1.11       ad 
    666  1.11       ad 	return rv;
    667  1.11       ad }
    668  1.11       ad 
    669  1.11       ad void
    670  1.11       ad bdev_strategy(struct buf *bp)
    671  1.11       ad {
    672  1.11       ad 	const struct bdevsw *d;
    673  1.17       ad 	int mpflag;
    674  1.11       ad 
    675  1.11       ad 	if ((d = bdevsw_lookup(bp->b_dev)) == NULL)
    676  1.11       ad 		panic("bdev_strategy");
    677  1.11       ad 
    678  1.11       ad 	DEV_LOCK(d);
    679  1.11       ad 	(*d->d_strategy)(bp);
    680  1.11       ad 	DEV_UNLOCK(d);
    681  1.11       ad }
    682  1.11       ad 
    683  1.11       ad int
    684  1.11       ad bdev_ioctl(dev_t dev, u_long cmd, void *data, int flag, lwp_t *l)
    685  1.11       ad {
    686  1.11       ad 	const struct bdevsw *d;
    687  1.17       ad 	int rv, mpflag;
    688  1.11       ad 
    689  1.11       ad 	if ((d = bdevsw_lookup(dev)) == NULL)
    690  1.11       ad 		return ENXIO;
    691  1.11       ad 
    692  1.11       ad 	DEV_LOCK(d);
    693  1.11       ad 	rv = (*d->d_ioctl)(dev, cmd, data, flag, l);
    694  1.11       ad 	DEV_UNLOCK(d);
    695  1.11       ad 
    696  1.11       ad 	return rv;
    697  1.11       ad }
    698  1.11       ad 
    699  1.11       ad int
    700  1.11       ad bdev_dump(dev_t dev, daddr_t addr, void *data, size_t sz)
    701  1.11       ad {
    702  1.11       ad 	const struct bdevsw *d;
    703  1.11       ad 	int rv;
    704  1.11       ad 
    705  1.11       ad 	/*
    706  1.11       ad 	 * Dump can be called without the device open.  Since it can
    707  1.11       ad 	 * currently only be called with the system paused (and in a
    708  1.11       ad 	 * potentially unstable state), we don't perform any locking.
    709  1.11       ad 	 */
    710  1.11       ad 	if ((d = bdevsw_lookup(dev)) == NULL)
    711  1.11       ad 		return ENXIO;
    712  1.11       ad 
    713  1.11       ad 	/* DEV_LOCK(d); */
    714  1.11       ad 	rv = (*d->d_dump)(dev, addr, data, sz);
    715  1.11       ad 	/* DEV_UNLOCK(d); */
    716  1.11       ad 
    717  1.11       ad 	return rv;
    718  1.11       ad }
    719  1.11       ad 
    720  1.11       ad int
    721  1.11       ad bdev_type(dev_t dev)
    722  1.11       ad {
    723  1.11       ad 	const struct bdevsw *d;
    724  1.11       ad 
    725  1.11       ad 	if ((d = bdevsw_lookup(dev)) == NULL)
    726  1.11       ad 		return D_OTHER;
    727  1.11       ad 	return d->d_flag & D_TYPEMASK;
    728  1.11       ad }
    729  1.11       ad 
    730  1.11       ad int
    731  1.11       ad cdev_open(dev_t dev, int flag, int devtype, lwp_t *l)
    732  1.11       ad {
    733  1.11       ad 	const struct cdevsw *d;
    734  1.17       ad 	int rv, mpflag;
    735  1.11       ad 
    736  1.11       ad 	/*
    737  1.11       ad 	 * For open we need to lock, in order to synchronize
    738  1.11       ad 	 * with attach/detach.
    739  1.11       ad 	 */
    740  1.20       ad 	mutex_enter(&specfs_lock);
    741  1.11       ad 	d = cdevsw_lookup(dev);
    742  1.20       ad 	mutex_exit(&specfs_lock);
    743  1.11       ad 	if (d == NULL)
    744  1.11       ad 		return ENXIO;
    745  1.11       ad 
    746  1.11       ad 	DEV_LOCK(d);
    747  1.11       ad 	rv = (*d->d_open)(dev, flag, devtype, l);
    748  1.11       ad 	DEV_UNLOCK(d);
    749  1.11       ad 
    750  1.11       ad 	return rv;
    751  1.11       ad }
    752  1.11       ad 
    753  1.11       ad int
    754  1.11       ad cdev_close(dev_t dev, int flag, int devtype, lwp_t *l)
    755  1.11       ad {
    756  1.11       ad 	const struct cdevsw *d;
    757  1.17       ad 	int rv, mpflag;
    758  1.11       ad 
    759  1.11       ad 	if ((d = cdevsw_lookup(dev)) == NULL)
    760  1.11       ad 		return ENXIO;
    761  1.11       ad 
    762  1.11       ad 	DEV_LOCK(d);
    763  1.11       ad 	rv = (*d->d_close)(dev, flag, devtype, l);
    764  1.11       ad 	DEV_UNLOCK(d);
    765  1.11       ad 
    766  1.11       ad 	return rv;
    767  1.11       ad }
    768  1.11       ad 
    769  1.11       ad int
    770  1.11       ad cdev_read(dev_t dev, struct uio *uio, int flag)
    771  1.11       ad {
    772  1.11       ad 	const struct cdevsw *d;
    773  1.17       ad 	int rv, mpflag;
    774  1.11       ad 
    775  1.11       ad 	if ((d = cdevsw_lookup(dev)) == NULL)
    776  1.11       ad 		return ENXIO;
    777  1.11       ad 
    778  1.11       ad 	DEV_LOCK(d);
    779  1.11       ad 	rv = (*d->d_read)(dev, uio, flag);
    780  1.11       ad 	DEV_UNLOCK(d);
    781  1.11       ad 
    782  1.11       ad 	return rv;
    783  1.11       ad }
    784  1.11       ad 
    785  1.11       ad int
    786  1.11       ad cdev_write(dev_t dev, struct uio *uio, int flag)
    787  1.11       ad {
    788  1.11       ad 	const struct cdevsw *d;
    789  1.17       ad 	int rv, mpflag;
    790  1.11       ad 
    791  1.11       ad 	if ((d = cdevsw_lookup(dev)) == NULL)
    792  1.11       ad 		return ENXIO;
    793  1.11       ad 
    794  1.11       ad 	DEV_LOCK(d);
    795  1.11       ad 	rv = (*d->d_write)(dev, uio, flag);
    796  1.11       ad 	DEV_UNLOCK(d);
    797  1.11       ad 
    798  1.11       ad 	return rv;
    799  1.11       ad }
    800  1.11       ad 
    801  1.11       ad int
    802  1.11       ad cdev_ioctl(dev_t dev, u_long cmd, void *data, int flag, lwp_t *l)
    803  1.11       ad {
    804  1.11       ad 	const struct cdevsw *d;
    805  1.17       ad 	int rv, mpflag;
    806  1.11       ad 
    807  1.11       ad 	if ((d = cdevsw_lookup(dev)) == NULL)
    808  1.11       ad 		return ENXIO;
    809  1.11       ad 
    810  1.11       ad 	DEV_LOCK(d);
    811  1.11       ad 	rv = (*d->d_ioctl)(dev, cmd, data, flag, l);
    812  1.11       ad 	DEV_UNLOCK(d);
    813  1.11       ad 
    814  1.11       ad 	return rv;
    815  1.11       ad }
    816  1.11       ad 
    817  1.11       ad void
    818  1.11       ad cdev_stop(struct tty *tp, int flag)
    819  1.11       ad {
    820  1.11       ad 	const struct cdevsw *d;
    821  1.17       ad 	int mpflag;
    822  1.11       ad 
    823  1.11       ad 	if ((d = cdevsw_lookup(tp->t_dev)) == NULL)
    824  1.11       ad 		return;
    825  1.11       ad 
    826  1.11       ad 	DEV_LOCK(d);
    827  1.11       ad 	(*d->d_stop)(tp, flag);
    828  1.11       ad 	DEV_UNLOCK(d);
    829  1.11       ad }
    830  1.11       ad 
    831  1.11       ad struct tty *
    832  1.11       ad cdev_tty(dev_t dev)
    833  1.11       ad {
    834  1.11       ad 	const struct cdevsw *d;
    835  1.11       ad 	struct tty * rv;
    836  1.17       ad 	int mpflag;
    837  1.11       ad 
    838  1.11       ad 	if ((d = cdevsw_lookup(dev)) == NULL)
    839  1.11       ad 		return NULL;
    840  1.11       ad 
    841  1.12       ad 	/* XXX Check if necessary. */
    842  1.12       ad 	if (d->d_tty == NULL)
    843  1.12       ad 		return NULL;
    844  1.12       ad 
    845  1.11       ad 	DEV_LOCK(d);
    846  1.11       ad 	rv = (*d->d_tty)(dev);
    847  1.11       ad 	DEV_UNLOCK(d);
    848  1.11       ad 
    849  1.11       ad 	return rv;
    850  1.11       ad }
    851  1.11       ad 
    852  1.11       ad int
    853  1.11       ad cdev_poll(dev_t dev, int flag, lwp_t *l)
    854  1.11       ad {
    855  1.11       ad 	const struct cdevsw *d;
    856  1.17       ad 	int rv, mpflag;
    857  1.11       ad 
    858  1.11       ad 	if ((d = cdevsw_lookup(dev)) == NULL)
    859  1.11       ad 		return POLLERR;
    860  1.11       ad 
    861  1.11       ad 	DEV_LOCK(d);
    862  1.11       ad 	rv = (*d->d_poll)(dev, flag, l);
    863  1.11       ad 	DEV_UNLOCK(d);
    864  1.11       ad 
    865  1.11       ad 	return rv;
    866  1.11       ad }
    867  1.11       ad 
    868  1.11       ad paddr_t
    869  1.11       ad cdev_mmap(dev_t dev, off_t off, int flag)
    870  1.11       ad {
    871  1.11       ad 	const struct cdevsw *d;
    872  1.11       ad 	paddr_t rv;
    873  1.17       ad 	int mpflag;
    874  1.11       ad 
    875  1.11       ad 	if ((d = cdevsw_lookup(dev)) == NULL)
    876  1.11       ad 		return (paddr_t)-1LL;
    877  1.11       ad 
    878  1.11       ad 	DEV_LOCK(d);
    879  1.11       ad 	rv = (*d->d_mmap)(dev, off, flag);
    880  1.11       ad 	DEV_UNLOCK(d);
    881  1.11       ad 
    882  1.11       ad 	return rv;
    883  1.11       ad }
    884  1.11       ad 
    885  1.11       ad int
    886  1.11       ad cdev_kqfilter(dev_t dev, struct knote *kn)
    887  1.11       ad {
    888  1.11       ad 	const struct cdevsw *d;
    889  1.17       ad 	int rv, mpflag;
    890  1.11       ad 
    891  1.11       ad 	if ((d = cdevsw_lookup(dev)) == NULL)
    892  1.11       ad 		return ENXIO;
    893  1.11       ad 
    894  1.11       ad 	DEV_LOCK(d);
    895  1.11       ad 	rv = (*d->d_kqfilter)(dev, kn);
    896  1.11       ad 	DEV_UNLOCK(d);
    897  1.11       ad 
    898  1.11       ad 	return rv;
    899  1.11       ad }
    900  1.11       ad 
    901  1.11       ad int
    902  1.11       ad cdev_type(dev_t dev)
    903  1.11       ad {
    904  1.11       ad 	const struct cdevsw *d;
    905  1.11       ad 
    906  1.11       ad 	if ((d = cdevsw_lookup(dev)) == NULL)
    907  1.11       ad 		return D_OTHER;
    908  1.11       ad 	return d->d_flag & D_TYPEMASK;
    909   1.2  gehenna }
    910