diff options
Diffstat (limited to 'usr/src/uts/common/sys/ramdisk.h')
| -rw-r--r-- | usr/src/uts/common/sys/ramdisk.h | 232 |
1 files changed, 232 insertions, 0 deletions
diff --git a/usr/src/uts/common/sys/ramdisk.h b/usr/src/uts/common/sys/ramdisk.h new file mode 100644 index 0000000000..a33e2d1cb1 --- /dev/null +++ b/usr/src/uts/common/sys/ramdisk.h @@ -0,0 +1,232 @@ +/* + * CDDL HEADER START + * + * The contents of this file are subject to the terms of the + * Common Development and Distribution License, Version 1.0 only + * (the "License"). You may not use this file except in compliance + * with the License. + * + * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE + * or http://www.opensolaris.org/os/licensing. + * See the License for the specific language governing permissions + * and limitations under the License. + * + * When distributing Covered Code, include this CDDL HEADER in each + * file and include the License file at usr/src/OPENSOLARIS.LICENSE. + * If applicable, add the following below this CDDL HEADER, with the + * fields enclosed by brackets "[]" replaced with your own identifying + * information: Portions Copyright [yyyy] [name of copyright owner] + * + * CDDL HEADER END + */ +/* + * Copyright 2004 Sun Microsystems, Inc. All rights reserved. + * Use is subject to license terms. + */ + +#ifndef _SYS_RAMDISK_H +#define _SYS_RAMDISK_H + +#pragma ident "%Z%%M% %I% %E% SMI" + +#include <sys/types.h> +#include <sys/time.h> +#include <sys/vtoc.h> +#include <sys/dkio.h> +#include <sys/vnode.h> + +#ifdef __cplusplus +extern "C" { +#endif + +/* + * /dev names: + * /dev/ramdiskctl - control device + * /dev/ramdisk/<name> - block devices + * /dev/rramdisk/<name> - character devices + */ +#define RD_DRIVER_NAME "ramdisk" +#define RD_BLOCK_NAME RD_DRIVER_NAME +#define RD_CHAR_NAME "r" RD_DRIVER_NAME + +#define RD_CTL_NODE "ctl" +#define RD_CTL_NAME RD_DRIVER_NAME RD_CTL_NODE + +/* + * Minor number 0 is reserved for the controlling device. All other ramdisks + * are assigned minor numbers 1..rd_max_disks. The minor number is used as + * an index into the 'rd_devstate' structures. + */ +#define RD_CTL_MINOR 0 + +/* + * Maximum number of ramdisks supported by this driver. + */ +#define RD_MAX_DISKS 1024 + +/* + * Properties exported by the driver. + */ +#define NBLOCKS_PROP_NAME "Nblocks" +#define SIZE_PROP_NAME "Size" + +/* + * Strip any "ramdisk-" prefix from the name of OBP-created ramdisks. + */ +#define RD_OBP_PFXSTR "ramdisk-" +#define RD_OBP_PFXLEN (sizeof (RD_OBP_PFXSTR) - 1) + +#define RD_STRIP_PREFIX(newname, oldname) \ + { \ + char *onm = oldname; \ + newname = strncmp(onm, RD_OBP_PFXSTR, RD_OBP_PFXLEN) == 0 ? \ + (onm + RD_OBP_PFXLEN) : onm; \ + } + +/* + * Strip any ",raw" suffix from the name of pseudo ramdisk devices. + */ +#define RD_STRIP_SUFFIX(name) \ + { \ + char *str = strstr((name), ",raw"); \ + if (str != NULL) \ + *str = '\0'; \ + } + +/* + * Interface between the ramdisk(7D) driver and ramdiskadm(1M). Use is: + * + * fd = open("/dev/ramdiskctl", O_RDWR | O_EXCL); + * + * 'ramdiskctl' must be opened exclusively. Access is controlled by permissions + * on the device, which is 0644 by default. Write-access is required for the + * allocation and deletion of ramdisks, but only read-access is required for + * the remaining ioctls which simply return information. + * + * ioctl usage: + * + * struct rd_ioctl ri; + * + * strlcpy(ri.ri_name, "somediskname", sizeof (ri.ri_name)); + * ri.ri_size = somedisksize; + * ioctl(fd, RD_CREATE_DISK, &ri); + * + * strlcpy(ri.ri_name, "somediskname", sizeof (ri.ri_name)); + * ioctl(fd, RD_DELETE_DISK, &ri); + * + * (only ramdisks created using the RD_CREATE_DISK ioctl can be deleted + * by the RD_DELETE_DISK ioctl). + * + * Note that these ioctls are completely private, and only for the use of + * ramdiskadm(1M). + */ +#define RD_IOC_BASE (('R' << 16) | ('D' << 8)) + +#define RD_CREATE_DISK (RD_IOC_BASE | 0x01) +#define RD_DELETE_DISK (RD_IOC_BASE | 0x02) + +#define RD_NAME_LEN 32 /* Max length of ramdisk name */ +#define RD_NAME_PAD 7 /* Pad ri_name to 8-bytes */ + +struct rd_ioctl { + char ri_name[RD_NAME_LEN + 1]; + char _ri_pad[RD_NAME_PAD]; + uint64_t ri_size; +}; + +#if defined(_KERNEL) + +/* + * We limit the maximum number of active ramdisk devices to 32, tuneable + * up to a maximum of 1023. Minor 0 is always reserved for the controlling + * device. You can change this by setting a value for 'max_disks' in + * ramdisk.conf. + */ +#define RD_DFLT_DISKS 32 + +/* + * The maximum amount of memory that can be consumed before starving the + * kernel depends loosely on the number of cpus, the speed of those cpus, + * and other hardware characteristics, and is thus highly machine-dependent. + * The default value of 'rd_percent_physmem' is 25% of physical memory, + * but this can be changed by setting a value for 'percent_physmem' in + * ramdisk.conf. + */ +#define RD_DEFAULT_PERCENT_PHYSMEM 25 + +/* + * Maximum size of a physical transfer? + */ +#define RD_DEFAULT_MAXPHYS (63 * 1024) /* '126b' */ + +/* + * A real OBP-created ramdisk consists of one or more physical address + * ranges; these are described by the 'existing' property, whose value + * is a (corresponding) number of {phys,size} pairs. + */ +#define RD_EXISTING_PROP_NAME "existing" + +typedef struct { + uint64_t phys; /* Phys addr of range */ + uint64_t size; /* Size of range */ +} rd_existing_t; + + +#define RD_WINDOW_NOT_MAPPED 1 /* Valid window is on page boundary */ + +/* + * The entire state of each ramdisk device. The rd_dip field will reference + * the actual devinfo for real OBP-created ramdisks, or the generic devinfo + * 'rd_dip' for pseudo ramdisk devices. + */ +typedef struct rd_devstate { + kmutex_t rd_device_lock; /* Per device lock */ + char rd_name[RD_NAME_LEN + 1]; + dev_info_t *rd_dip; /* My devinfo handle */ + minor_t rd_minor; /* Full minor number */ + size_t rd_size; /* Size in bytes */ + /* + * {rd_nexisting, rd_existing} and {rd_npages, rd_ppa} are + * mutually exclusive; the former describe an OBP-created + * ramdisk, the latter a 'pseudo' ramdisk. + */ + uint_t rd_nexisting; /* # 'existing' structs */ + rd_existing_t *rd_existing; + pgcnt_t rd_npages; /* # physical pages */ + page_t **rd_ppa; + /* + * Fields describing a virtual window onto the physical ramdisk, + * giving the offset within the ramdisk of the window, its size, + * and its virtual address (in the kernel heap). + */ + offset_t rd_window_base; + uint64_t rd_window_size; + caddr_t rd_window_virt; + /* + * Fields to count opens/closes of the ramdisk. + */ + uint32_t rd_blk_open; + uint32_t rd_chr_open; + uint32_t rd_lyr_open_cnt; + /* + * Fields to maintain a faked geometry of the disk. + */ + struct dk_geom rd_dkg; + struct vtoc rd_vtoc; + struct dk_cinfo rd_ci; + /* + * Kstat stuff. + */ + kmutex_t rd_kstat_lock; + kstat_t *rd_kstat; +} rd_devstate_t; + +extern int is_pseudo_device(dev_info_t *); + +#endif + +#ifdef __cplusplus +} +#endif + +#endif /* _SYS_RAMDISK_H */ |
