diff options
Diffstat (limited to 'usr/src/man/man9e')
49 files changed, 253 insertions, 925 deletions
diff --git a/usr/src/man/man9e/Intro.9e b/usr/src/man/man9e/Intro.9e index 13a9deeb4a..5c18acbee2 100644 --- a/usr/src/man/man9e/Intro.9e +++ b/usr/src/man/man9e/Intro.9e @@ -4,7 +4,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH Intro 9E "15 May 2001" "SunOS 5.11" "Driver Entry Points" +.TH INTRO 9E "May 15, 2001" .SH NAME Intro, intro \- overview of device driver interfaces and introduction to driver entry points @@ -205,46 +205,38 @@ Association (PCMCIA) and the Japan Electronic Industry Development Association Section 9 is divided into the following subsections: .sp .ne 2 -.mk .na \fB\fB9E\fR \fR .ad .RS 7n -.rt Driver Entry Points - contains reference pages for all driver entry point routines. .RE .sp .ne 2 -.mk .na \fB\fB9F\fR \fR .ad .RS 7n -.rt Kernel Functions - contains reference pages for all driver support routines. .RE .sp .ne 2 -.mk .na \fB\fB9P\fR \fR .ad .RS 7n -.rt Driver Properties - contains reference pages for driver properties. .RE .sp .ne 2 -.mk .na \fB\fB9S\fR \fR .ad .RS 7n -.rt Data Structures - contains reference pages for driver-related structures. .RE @@ -339,14 +331,12 @@ this section. .sp .TS -tab(); -cw(2.75i) cw(2.75i) -lw(2.75i) lw(2.75i) -. -\fBRoutine\fR\fBType\fR +c c +l l . +\fBRoutine\fR \fBType\fR _ -\fBput\fRDDI/DKI -\fBsrv\fRDDI/DKI +\fBput\fR DDI/DKI +\fBsrv\fR DDI/DKI .TE .sp @@ -357,58 +347,56 @@ section. .sp .TS -tab(); -cw(2.18i) cw(3.32i) -lw(2.18i) lw(3.32i) -. -\fBRoutine\fR\fBType \fR +c c +l l . +\fBRoutine\fR \fBType \fR _ -\fB_fini\fRSolaris DDI -\fB_info\fRSolaris DDI -\fB_init\fRSolaris DDI -\fBaread\fRSolaris DDI -\fBattach\fRSolaris DDI -\fBawrite\fRSolaris DDI -\fBchpoll\fRDDI/DKI -\fBclose\fRDDI/DKI -\fBdetach\fRSolaris DDI -\fBdevmap\fRSolaris DDI -\fBdevmap_access\fRSolaris DDI -\fBdevmap_contextmgt\fRSolaris DDI -\fBdevmap_dup\fRSolaris DDI -\fBdevmap_map\fRSolaris DDI -\fBdevmap_unmap\fRSolaris DDI -\fBdump\fRSolaris DDI -\fBgetinfo\fRSolaris DDI -\fBidentify\fRSolaris DDI -\fBioctl\fRDDI/DKI -\fBks_update\fRSolaris DDI -\fBmapdev_access\fRSolaris DDI -\fBmapdev_dup\fRSolaris DDI -\fBmapdev_free\fRSolaris DDI -\fBmmap\fRDKI only -\fBopen\fRDDI/DKI -\fBpower\fRSolaris DDI -\fBprint\fRDDI/DKI -\fBprobe\fRSolaris DDI -\fBprop_op\fRSolaris DDI -\fBread\fRDDI/DKI -\fBsegmap\fRDKI only -\fBstrategy\fRDDI/DKI -\fBtran_abort\fRSolaris DDI -\fBtran_destroy_pkt\fRSolaris DDI -\fBtran_dmafree\fRSolaris DDI -\fBtran_getcap\fRSolaris DDI -\fBtran_init_pkt\fRSolaris DDI -\fBtran_reset\fRSolaris DDI -\fBtran_reset_notify\fRSolaris DDI -\fBtran_setcap\fRSolaris DDI -\fBtran_start\fRSolaris DDI -\fBtran_sync_pkt\fRSolaris DDI -\fBtran_tgt_free\fRSolaris DDI -\fBtran_tgt_init\fRSolaris DDI -\fBtran_tgt_probe\fRSolaris DDI -\fBwrite\fRDDI/DKI +\fB_fini\fR Solaris DDI +\fB_info\fR Solaris DDI +\fB_init\fR Solaris DDI +\fBaread\fR Solaris DDI +\fBattach\fR Solaris DDI +\fBawrite\fR Solaris DDI +\fBchpoll\fR DDI/DKI +\fBclose\fR DDI/DKI +\fBdetach\fR Solaris DDI +\fBdevmap\fR Solaris DDI +\fBdevmap_access\fR Solaris DDI +\fBdevmap_contextmgt\fR Solaris DDI +\fBdevmap_dup\fR Solaris DDI +\fBdevmap_map\fR Solaris DDI +\fBdevmap_unmap\fR Solaris DDI +\fBdump\fR Solaris DDI +\fBgetinfo\fR Solaris DDI +\fBidentify\fR Solaris DDI +\fBioctl\fR DDI/DKI +\fBks_update\fR Solaris DDI +\fBmapdev_access\fR Solaris DDI +\fBmapdev_dup\fR Solaris DDI +\fBmapdev_free\fR Solaris DDI +\fBmmap\fR DKI only +\fBopen\fR DDI/DKI +\fBpower\fR Solaris DDI +\fBprint\fR DDI/DKI +\fBprobe\fR Solaris DDI +\fBprop_op\fR Solaris DDI +\fBread\fR DDI/DKI +\fBsegmap\fR DKI only +\fBstrategy\fR DDI/DKI +\fBtran_abort\fR Solaris DDI +\fBtran_destroy_pkt\fR Solaris DDI +\fBtran_dmafree\fR Solaris DDI +\fBtran_getcap\fR Solaris DDI +\fBtran_init_pkt\fR Solaris DDI +\fBtran_reset\fR Solaris DDI +\fBtran_reset_notify\fR Solaris DDI +\fBtran_setcap\fR Solaris DDI +\fBtran_start\fR Solaris DDI +\fBtran_sync_pkt\fR Solaris DDI +\fBtran_tgt_free\fR Solaris DDI +\fBtran_tgt_init\fR Solaris DDI +\fBtran_tgt_probe\fR Solaris DDI +\fBwrite\fR DDI/DKI .TE .sp @@ -430,41 +418,39 @@ declared as \fBvoid\fR (no error is returned). .sp .TS -tab(); -cw(1.69i) cw(3.81i) -lw(1.69i) lw(3.81i) -. -Error ValueError Description +c c +l l . +Error Value Error Description _ -EAGAINT{ +EAGAIN T{ Kernel resources, such as the buf structure or cache memory, are not available at this time (device may be busy, or the system resource is not available). This is used in open, ioctl, read, write, and strategy. T} _ -EFAULTT{ +EFAULT T{ An invalid address has been passed as an argument; memory addressing error. This is used in open, close, ioctl, read, write, and strategy. T} _ -EINTRT{ +EINTR T{ Sleep interrupted by signal. This is used in open, close, ioctl, read, write, and strategy. T} _ -EINVALT{ +EINVAL T{ An invalid argument was passed to the routine. This is used in open, ioctl, read, write, and strategy. T} _ -EIOT{ +EIO T{ A device error occurred; an error condition was detected in a device status register (the I/O request was valid, but an error occurred on the device). This is used in open, close, ioctl, read, write, and strategy. T} _ -ENXIOT{ +ENXIO T{ An attempt was made to access a device or subdevice that does not exist (one that is not configured); an attempt was made to perform an invalid I/O operation; an incorrect minor number was specified. This is used in open, close, ioctl, read, write, and strategy. T} _ -EPERMT{ +EPERM T{ A process attempting an operation did not have required permission. This is used in open, ioctl, read, write, and strategy. T} _ -EROFST{ +EROFS T{ An attempt was made to open for writing a read-only device. This is used in open. T} .TE @@ -477,20 +463,19 @@ the error values can be returned. .sp .TS -tab() box; -cw(1.08i) |cw(1.11i) |cw(1.12i) |cw(2.18i) -lw(1.08i) |lw(1.11i) |lw(1.12i) |lw(2.18i) -. -opencloseioctlread, write and strategy +box; +c | c | c | c +l | l | l | l . +open close ioctl read, write and strategy _ -EAGAINEFAULTEAGAINEAGAIN -EFAULTEINTREFAULTEFAULT -EINTREIOEINTREINTR -EINVALENXIOEINVALEINVAL -EIOEIOEIO -ENXIOENXIOENXIO -EPERMEPERM -EROFS +EAGAIN EFAULT EAGAIN EAGAIN +EFAULT EINTR EFAULT EFAULT +EINTR EIO EINTR EINTR +EINVAL ENXIO EINVAL EINVAL +EIO EIO EIO +ENXIO ENXIO ENXIO +EPERM EPERM +EROFS .TE .SH SEE ALSO diff --git a/usr/src/man/man9e/_fini.9e b/usr/src/man/man9e/_fini.9e index b9677f09d7..19cd7b665f 100644 --- a/usr/src/man/man9e/_fini.9e +++ b/usr/src/man/man9e/_fini.9e @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH _fini 9E "22 Jan 2002" "SunOS 5.11" "Driver Entry Points" +.TH _FINI 9E "Jan 22, 2002" .SH NAME _fini, _info, _init \- loadable module configuration entry points .SH SYNOPSIS @@ -35,12 +35,10 @@ write them. .SS "_info(\|)" .sp .ne 2 -.mk .na \fB\fImodinfop\fR \fR .ad .RS 13n -.rt A pointer to an opaque \fBmodinfo\fR structure. .RE @@ -135,7 +133,7 @@ _init(void) return (i); } - + int _info(struct modinfo *modinfop) { @@ -147,7 +145,7 @@ int _fini(void) { int i; - + /* * If mod_remove() is successful, we destroy our global mutex */ diff --git a/usr/src/man/man9e/aread.9e b/usr/src/man/man9e/aread.9e index 9fde07cc96..c163e35f18 100644 --- a/usr/src/man/man9e/aread.9e +++ b/usr/src/man/man9e/aread.9e @@ -4,7 +4,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH aread 9E "28 Mar 1997" "SunOS 5.11" "Driver Entry Points" +.TH AREAD 9E "Mar 28, 1997" .SH NAME aread \- asynchronous read from a device .SH SYNOPSIS @@ -29,35 +29,29 @@ Drivers that do not support an \fBaread()\fR entry point should use .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIdev\fR \fR .ad .RS 13n -.rt Device number. .RE .sp .ne 2 -.mk .na \fB\fIaio_reqp\fR \fR .ad .RS 13n -.rt Pointer to the \fBaio_req\fR(9S) structure that describes where the data is to be stored. .RE .sp .ne 2 -.mk .na \fB\fIcred_p\fR \fR .ad .RS 13n -.rt Pointer to the credential structure. .RE @@ -102,7 +96,7 @@ xxaread(dev_t dev, struct aio_req *aio, cred_t *cred_p) /*Verify soft state structure has been allocated */ if (xsp == NULL) return (ENXIO); - return (aphysio(xxstrategy, anocancel, + return (aphysio(xxstrategy, anocancel, dev, B_READ, xxminphys, aio)); } .fi diff --git a/usr/src/man/man9e/attach.9e b/usr/src/man/man9e/attach.9e index b98b9d0379..39ec5635cc 100644 --- a/usr/src/man/man9e/attach.9e +++ b/usr/src/man/man9e/attach.9e @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH attach 9E "7 Jan 2004" "SunOS 5.11" "Driver Entry Points" +.TH ATTACH 9E "Jan 7, 2004" .SH NAME attach \- Attach a device to the system, or resume it .SH SYNOPSIS @@ -24,23 +24,19 @@ Solaris DDI specific (Solaris DDI) .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIdip\fR\fR .ad .RS 7n -.rt A pointer to the device's \fBdev_info\fR structure. .RE .sp .ne 2 -.mk .na \fB\fIcmd\fR\fR .ad .RS 7n -.rt Attach type. Possible values are \fBDDI_ATTACH\fR and \fBDDI_RESUME\fR. Other values are reserved. The driver must return \fBDDI_FAILURE\fR if reserved values are passed to it. @@ -130,23 +126,19 @@ loading firmware so that it can detect hot-plug events). The \fBattach()\fR function returns: .sp .ne 2 -.mk .na \fB\fBDDI_SUCCESS\fR\fR .ad .RS 15n -.rt Successful completion .RE .sp .ne 2 -.mk .na \fB\fBDDI_FAILURE\fR\fR .ad .RS 15n -.rt Operation failed .RE @@ -158,13 +150,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man9e/awrite.9e b/usr/src/man/man9e/awrite.9e index 93da0bfd46..c3ac9b6032 100644 --- a/usr/src/man/man9e/awrite.9e +++ b/usr/src/man/man9e/awrite.9e @@ -4,7 +4,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH awrite 9E "28 Mar 1997" "SunOS 5.11" "Driver Entry Points" +.TH AWRITE 9E "Mar 28, 1997" .SH NAME awrite \- asynchronous write to a device .SH SYNOPSIS @@ -16,7 +16,7 @@ awrite \- asynchronous write to a device #include <sys/ddi.h> #include <sys/sunddi.h> -\fBintprefix\fR\fBawrite\fR(\fBdev_t\fR \fIdev\fR, \fBstruct aio_req *\fR\fIaio_reqp\fR, +\fBintprefix\fR\fBawrite\fR(\fBdev_t\fR \fIdev\fR, \fBstruct aio_req *\fR\fIaio_reqp\fR, \fBcred_t *\fR\fIcred_p\fR); .fi @@ -28,35 +28,29 @@ that do not support an \fBawrite()\fR entry point should use \fBnodev\fR(9F) .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIdev\fR\fR .ad .RS 12n -.rt Device number. .RE .sp .ne 2 -.mk .na \fB\fIaio_reqp\fR\fR .ad .RS 12n -.rt Pointer to the \fBaio_req\fR(9S) structure that describes where the data is stored. .RE .sp .ne 2 -.mk .na \fB\fIcred_p\fR\fR .ad .RS 12n -.rt Pointer to the credential structure. .RE diff --git a/usr/src/man/man9e/chpoll.9e b/usr/src/man/man9e/chpoll.9e index 1dbf19d5a7..a2adaf7a9c 100644 --- a/usr/src/man/man9e/chpoll.9e +++ b/usr/src/man/man9e/chpoll.9e @@ -4,7 +4,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH chpoll 9E "7 May 2008" "SunOS 5.11" "Driver Entry Points" +.TH CHPOLL 9E "May 7, 2008" .SH NAME chpoll \- poll entry point for a non-STREAMS character driver .SH SYNOPSIS @@ -17,7 +17,7 @@ chpoll \- poll entry point for a non-STREAMS character driver -\fBint prefix\fR\fBchpoll\fR(\fBdev_t\fR \fIdev\fR, \fBshort\fR \fIevents\fR, \fBint\fR \fIanyyet\fR, +\fBint prefix\fR\fBchpoll\fR(\fBdev_t\fR \fIdev\fR, \fBshort\fR \fIevents\fR, \fBint\fR \fIanyyet\fR, \fBshort *\fR\fIreventsp\fR, \fBstruct pollhead **\fR\fIphpp\fR); .fi @@ -28,120 +28,98 @@ This entry point is optional. Architecture independent level 1 (DDI/DKI). .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIdev\fR\fR .ad .RS 12n -.rt The device number for the device to be polled. .RE .sp .ne 2 -.mk .na \fB\fIevents\fR\fR .ad .RS 12n -.rt The events that may occur. Valid events are: .sp .ne 2 -.mk .na \fB\fBPOLLIN\fR\fR .ad .RS 14n -.rt Data other than high priority data may be read without blocking. .RE .sp .ne 2 -.mk .na \fB\fBPOLLOUT\fR\fR .ad .RS 14n -.rt Normal data may be written without blocking. .RE .sp .ne 2 -.mk .na \fB\fBPOLLPRI\fR\fR .ad .RS 14n -.rt High priority data may be received without blocking. .RE .sp .ne 2 -.mk .na \fB\fBPOLLHUP\fR\fR .ad .RS 14n -.rt A device hangup has occurred. .RE .sp .ne 2 -.mk .na \fB\fBPOLLERR\fR\fR .ad .RS 14n -.rt An error has occurred on the device. .RE .sp .ne 2 -.mk .na \fB\fBPOLLRDNORM\fR\fR .ad .RS 14n -.rt Normal data (priority band = 0) may be read without blocking. .RE .sp .ne 2 -.mk .na \fB\fBPOLLRDBAND\fR\fR .ad .RS 14n -.rt Data from a non-zero priority band may be read without blocking .RE .sp .ne 2 -.mk .na \fB\fBPOLLWRNORM\fR\fR .ad .RS 14n -.rt The same as \fBPOLLOUT\fR. .RE .sp .ne 2 -.mk .na \fB\fBPOLLWRBAND\fR\fR .ad .RS 14n -.rt Priority data (priority band > 0) may be written. .RE @@ -149,12 +127,10 @@ Priority data (priority band > 0) may be written. .sp .ne 2 -.mk .na \fB\fIanyyet\fR\fR .ad .RS 12n -.rt A flag that is non-zero if any other file descriptors in the \fBpollfd\fR array have events pending. The \fBpoll\fR(2) system call takes a pointer to an array of \fBpollfd\fR structures as one of its arguments. See the \fBpoll\fR(2) @@ -163,23 +139,19 @@ reference page for more details. .sp .ne 2 -.mk .na \fB\fIreventsp\fR\fR .ad .RS 12n -.rt A pointer to a bitmask of the returned events satisfied. .RE .sp .ne 2 -.mk .na \fB\fIphpp\fR\fR .ad .RS 12n -.rt A pointer to a pointer to a \fBpollhead\fR structure. .RE diff --git a/usr/src/man/man9e/close.9e b/usr/src/man/man9e/close.9e index a792f7e24a..b6703a20a7 100644 --- a/usr/src/man/man9e/close.9e +++ b/usr/src/man/man9e/close.9e @@ -4,7 +4,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH close 9E "24 Apr 2008" "SunOS 5.11" "Driver Entry Points" +.TH CLOSE 9E "Apr 24, 2008" .SH NAME close \- relinquish access to a device .SH SYNOPSIS @@ -50,23 +50,19 @@ for block devices. .SS "Block and Character" .sp .ne 2 -.mk .na \fB\fIdev\fR\fR .ad .RS 11n -.rt Device number. .RE .sp .ne 2 -.mk .na \fB\fIflag\fR\fR .ad .RS 11n -.rt File status flag, as set by the \fBopen\fR(2) or modified by the \fBfcntl\fR(2) system calls. The flag is for information only\(emthe file should always be closed completely. Possible values are: \fBFEXCL\fR, @@ -76,46 +72,38 @@ should always be closed completely. Possible values are: \fBFEXCL\fR, .sp .ne 2 -.mk .na \fB\fIotyp\fR\fR .ad .RS 11n -.rt Parameter supplied so that the driver can determine how many times a device was opened and for what reasons. The flags assume the \fBopen()\fR routine may be called many times, but the \fBclose()\fR routine should only be called on the last \fBclose()\fR of a device. .sp .ne 2 -.mk .na \fB\fBOTYP_BLK\fR\fR .ad .RS 12n -.rt Close was through block interface for the device. .RE .sp .ne 2 -.mk .na \fB\fBOTYP_CHR\fR\fR .ad .RS 12n -.rt Close was through the raw/character interface for the device. .RE .sp .ne 2 -.mk .na \fB\fBOTYP_LYR\fR\fR .ad .RS 12n -.rt Close a layered process (a higher-level driver called the \fBclose()\fR routine of the device). .RE @@ -124,24 +112,20 @@ of the device). .sp .ne 2 -.mk .na \fB\fI*cred_p\fR\fR .ad .RS 11n -.rt Pointer to the user credential structure. .RE .SS "STREAMS" .sp .ne 2 -.mk .na \fB\fI*q\fR\fR .ad .RS 11n -.rt Pointer to \fBqueue\fR(9S) structure used to reference the read side of the driver. (A queue is the central node of a collection of structures and routines pointed to by a queue.) @@ -149,23 +133,19 @@ routines pointed to by a queue.) .sp .ne 2 -.mk .na \fB\fIflag\fR\fR .ad .RS 11n -.rt File status flag. .RE .sp .ne 2 -.mk .na \fB\fI*cred_p\fR\fR .ad .RS 11n -.rt Pointer to the user credential structure. .RE diff --git a/usr/src/man/man9e/csx_event_handler.9e b/usr/src/man/man9e/csx_event_handler.9e index 719161fe32..66a4369844 100644 --- a/usr/src/man/man9e/csx_event_handler.9e +++ b/usr/src/man/man9e/csx_event_handler.9e @@ -3,17 +3,17 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH csx_event_handler 9E "22 Nov 1996" "SunOS 5.11" "Driver Entry Points" +.TH CSX_EVENT_HANDLER 9E "Nov 22, 1996" .SH NAME csx_event_handler \- PC Card driver event handler .SH SYNOPSIS .LP .nf -#include <sys/pccard.h> +#include <sys/pccard.h> -\fBint32_t prefix\fR\fBevent_handler\fR(\fBevent_t\fR \fIevent\fR, \fBint32_t\fR \fIpriority\fR, +\fBint32_t prefix\fR\fBevent_handler\fR(\fBevent_t\fR \fIevent\fR, \fBint32_t\fR \fIpriority\fR, \fBevent_callback_args_t *\fR\fIargs\fR); .fi @@ -24,34 +24,28 @@ Solaris architecture specific (Solaris \fBDDI) \fR .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIevent\fR\fR .ad .RS 12n -.rt The event. .RE .sp .ne 2 -.mk .na \fB\fIpriority\fR\fR .ad .RS 12n -.rt The priority of the event. .RE .sp .ne 2 -.mk .na \fB\fIargs\fR\fR .ad .RS 12n -.rt A pointer to the \fBevent_callback_t\fR structure. .RE @@ -93,7 +87,6 @@ The events and their indications are listed below; they are always delivered as low priority unless otherwise noted: .sp .ne 2 -.mk .na \fB\fBCS_EVENT_REGISTRATION_COMPLETE\fR\fR .ad @@ -104,7 +97,6 @@ A registration request processed in the background has been completed. .sp .ne 2 -.mk .na \fB\fBCS_EVENT_CARD_INSERTION\fR\fR .ad @@ -115,7 +107,6 @@ A \fBPC \fRCard has been inserted in a socket. .sp .ne 2 -.mk .na \fB\fBCS_EVENT_CARD_READY\fR\fR .ad @@ -127,7 +118,6 @@ state. .sp .ne 2 -.mk .na \fB\fBCS_EVENT_CARD_REMOVAL\fR\fR .ad @@ -144,7 +134,6 @@ other \fBPC \fRCards. .sp .ne 2 -.mk .na \fB\fBCS_EVENT_BATTERY_LOW\fR\fR .ad @@ -155,7 +144,6 @@ The battery on a \fBPC \fRCard is weak and is in need of replacement. .sp .ne 2 -.mk .na \fB\fBCS_EVENT_BATTERY_DEAD\fR\fR .ad @@ -166,7 +154,6 @@ The battery on a \fBPC \fRCard is no longer providing operational voltage. .sp .ne 2 -.mk .na \fB\fBCS_EVENT_PM_RESUME\fR\fR .ad @@ -178,7 +165,6 @@ Management software. .sp .ne 2 -.mk .na \fB\fBCS_EVENT_PM_SUSPEND\fR\fR .ad @@ -190,7 +176,6 @@ Management software. .sp .ne 2 -.mk .na \fB\fBCS_EVENT_CARD_LOCK\fR\fR .ad @@ -202,7 +187,6 @@ A mechanical latch has been manipulated preventing the removal of the \fBPC .sp .ne 2 -.mk .na \fB\fBCS_EVENT_CARD_UNLOCK\fR\fR .ad @@ -214,7 +198,6 @@ A mechanical latch has been manipulated allowing the removal of the \fBPC .sp .ne 2 -.mk .na \fB\fBCS_EVENT_EJECTION_REQUEST\fR\fR .ad @@ -226,7 +209,6 @@ mechanism. .sp .ne 2 -.mk .na \fB\fBCS_EVENT_EJECTION_COMPLETE\fR\fR .ad @@ -237,7 +219,6 @@ A motor has completed ejecting a \fBPC \fRCard from a socket. .sp .ne 2 -.mk .na \fB\fBCS_EVENT_ERASE_COMPLETE\fR\fR .ad @@ -248,7 +229,6 @@ A queued erase request that is processed in the background has been completed. .sp .ne 2 -.mk .na \fB\fBCS_EVENT_INSERTION_REQUEST\fR\fR .ad @@ -260,7 +240,6 @@ mechanism. .sp .ne 2 -.mk .na \fB\fBCS_EVENT_INSERTION_COMPLETE\fR\fR .ad @@ -271,7 +250,6 @@ A motor has completed inserting a \fBPC \fRCard in a socket. .sp .ne 2 -.mk .na \fB\fBCS_EVENT_CARD_RESET\fR\fR .ad @@ -282,7 +260,6 @@ A hardware reset has occurred. .sp .ne 2 -.mk .na \fB\fBCS_EVENT_RESET_REQUEST\fR\fR .ad @@ -293,7 +270,6 @@ A request for a physical reset by a client. .sp .ne 2 -.mk .na \fB\fBCS_EVENT_RESET_COMPLETE\fR\fR .ad @@ -304,7 +280,6 @@ A reset request that is processed in the background has been completed. .sp .ne 2 -.mk .na \fB\fBCS_EVENT_RESET_PHYSICAL\fR\fR .ad @@ -315,7 +290,6 @@ A reset is about to occur. .sp .ne 2 -.mk .na \fB\fBCS_EVENT_CLIENT_INFO\fR\fR .ad @@ -328,7 +302,6 @@ the \fBclient_info\fR structure as described below, and return \fBCS_SUCCESS\fR. Otherwise, it should return \fBCS_UNSUPPORTED_EVENT.\fR .sp .ne 2 -.mk .na \fB\fBargs->client_data.Attributes\fR\fR .ad @@ -339,7 +312,6 @@ Must be \fBOR\fR'ed with \fBCS_CLIENT_INFO_VALID\fR. .sp .ne 2 -.mk .na \fB\fBargs->client_data.Revision\fR\fR .ad @@ -350,7 +322,6 @@ Must be set to a driver-private version number. .sp .ne 2 -.mk .na \fB\fBargs->client_data.CSLevel\fR\fR .ad @@ -361,7 +332,6 @@ Must be set to \fBCS_VERSION\fR. .sp .ne 2 -.mk .na \fB\fBargs->client_data.RevDate\fR\fR .ad @@ -377,7 +347,6 @@ field could be set to a revision date of July 4 1997 with .sp .ne 2 -.mk .na \fB\fBargs->client_data.ClientName\fR\fR .ad @@ -388,7 +357,6 @@ A string describing the \fBPC \fRCard driver should be copied into this space. .sp .ne 2 -.mk .na \fB\fBargs->client_data.VendorName\fR\fR .ad @@ -400,7 +368,6 @@ into this space. .sp .ne 2 -.mk .na \fB\fBargs->client_data.DriverName\fR\fR .ad @@ -415,7 +382,6 @@ processed this event; the driver does not need to initialize this field. .sp .ne 2 -.mk .na \fB\fBCS_EVENT_WRITE_PROTECT\fR\fR .ad @@ -426,7 +392,6 @@ changed. The current write protect state of the \fBPC \fRCard is in the \fBargs->info\fR field: .sp .ne 2 -.mk .na \fB\fBCS_EVENT_WRITE_PROTECT_WPOFF\fR\fR .ad @@ -437,7 +402,6 @@ Card is not write protected. .sp .ne 2 -.mk .na \fB\fBCS_EVENT_WRITE_PROTECT_WPON\fR\fR .ad @@ -483,34 +447,28 @@ char DriverName[MODMAXNAMELEN]; .SH RETURN VALUES .sp .ne 2 -.mk .na \fB\fBCS_SUCCESS\fR\fR .ad .RS 24n -.rt The event was handled successfully. .RE .sp .ne 2 -.mk .na \fB\fBCS_UNSUPPORTED_EVENT\fR\fR .ad .RS 24n -.rt Driver does not support this event. .RE .sp .ne 2 -.mk .na \fB\fBCS_FAILURE\fR\fR .ad .RS 24n -.rt Error occurred while handling this event. .RE @@ -523,37 +481,37 @@ priority events, and from kernel context in the case of low priority events. .sp .in +2 .nf -static int -xx_event(event_t event, int priority, event_callback_args_t *args) -{ - int rval; - struct xxx *xxx = args->client_data; - client_info_t *info = &args->client_info; - - switch (event) { - case CS_EVENT_REGISTRATION_COMPLETE: - ASSERT(priority & CS_EVENT_PRI_LOW); - mutex_enter(&xxx->event_mutex); - xxx->card_state |= XX_REGISTRATION_COMPLETE; +static int +xx_event(event_t event, int priority, event_callback_args_t *args) +{ + int rval; + struct xxx *xxx = args->client_data; + client_info_t *info = &args->client_info; + + switch (event) { + case CS_EVENT_REGISTRATION_COMPLETE: + ASSERT(priority & CS_EVENT_PRI_LOW); + mutex_enter(&xxx->event_mutex); + xxx->card_state |= XX_REGISTRATION_COMPLETE; mutex_exit(&xxx->event_mutex); - rval = CS_SUCCESS; - break; + rval = CS_SUCCESS; + break; - case CS_EVENT_CARD_READY: + case CS_EVENT_CARD_READY: ASSERT(priority & CS_EVENT_PRI_LOW); - rval = xx_card_ready(xxx); - mutex_exit(&xxx->event_mutex); - break; + rval = xx_card_ready(xxx); + mutex_exit(&xxx->event_mutex); + break; - case CS_EVENT_CARD_INSERTION: - ASSERT(priority & CS_EVENT_PRI_LOW); + case CS_EVENT_CARD_INSERTION: + ASSERT(priority & CS_EVENT_PRI_LOW); mutex_enter(&xxx->event_mutex); - rval = xx_card_insertion(xxx); - mutex_exit(&xxx->event_mutex); + rval = xx_card_insertion(xxx); + mutex_exit(&xxx->event_mutex); break; - case CS_EVENT_CARD_REMOVAL: - if (priority & CS_EVENT_PRI_HIGH) { + case CS_EVENT_CARD_REMOVAL: + if (priority & CS_EVENT_PRI_HIGH) { mutex_enter(&xxx->hi_event_mutex); xxx->card_state &= ~XX_CARD_PRESENT; mutex_exit(&xxx->hi_event_mutex); @@ -562,29 +520,29 @@ xx_event(event_t event, int priority, event_callback_args_t *args) rval = xx_card_removal(xxx); mutex_exit(&xxx->event_mutex); } - break; + break; case CS_EVENT_CLIENT_INFO: ASSERT(priority & CS_EVENT_PRI_LOW); - if (GET_CLIENT_INFO_SUBSVC_CS(info->Attributes) == + if (GET_CLIENT_INFO_SUBSVC_CS(info->Attributes) == CS_CLIENT_INFO_SUBSVC_CS) { - info->Attributes |= CS_CLIENT_INFO_VALID; + info->Attributes |= CS_CLIENT_INFO_VALID; info->Revision = 4; info->CSLevel = CS_VERSION; info->RevDate = CS_CLIENT_INFO_MAKE_DATE(4, 7, 17); (void)strncpy(info->ClientName, "WhizBang Ultra Zowie PC card driver", - CS_CLIENT_INFO_MAX_NAME_LEN) - - "ACME PC card drivers, Inc.", - CS_CLIENT_INFO_MAX_NAME_LEN); - rval = CS_SUCCESS; - } else { + CS_CLIENT_INFO_MAX_NAME_LEN) + + "ACME PC card drivers, Inc.", + CS_CLIENT_INFO_MAX_NAME_LEN); + rval = CS_SUCCESS; + } else { rval = CS_UNSUPPORTED_EVENT; } - break; + break; + - case CS_EVENT_WRITE_PROTECT: ASSERT(priority & CS_EVENT_PRI_LOW); mutex_enter(&xxx->event_mutex); @@ -593,16 +551,16 @@ xx_event(event_t event, int priority, event_callback_args_t *args) } else { xxx->card_state |= XX_WRITE_PROTECTED; } - mutex_exit(&xxx->event_mutex); + mutex_exit(&xxx->event_mutex); rval = CS_SUCCESS; - break; + break; - default: - rval = CS_UNSUPPORTED_EVENT; + default: + rval = CS_UNSUPPORTED_EVENT; break; - } + } - return (rval); + return (rval); } .fi .in -2 diff --git a/usr/src/man/man9e/detach.9e b/usr/src/man/man9e/detach.9e index 20da374295..b5e1ec78b8 100644 --- a/usr/src/man/man9e/detach.9e +++ b/usr/src/man/man9e/detach.9e @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH detach 9E "7 Dec 2003" "SunOS 5.11" "Driver Entry Points" +.TH DETACH 9E "Dec 7, 2003" .SH NAME detach \- detach or suspend a device .SH SYNOPSIS @@ -24,23 +24,19 @@ Solaris DDI specific (Solaris DDI) .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIdip\fR\fR .ad .RS 7n -.rt A pointer to the device's \fBdev_info\fR structure. .RE .sp .ne 2 -.mk .na \fB\fIcmd\fR\fR .ad .RS 7n -.rt Type of detach; the driver should return \fBDDI_FAILURE\fR if any value other than \fBDDI_DETACH\fR or \fBDDI_SUSPEND\fR is passed to it. .RE @@ -128,12 +124,10 @@ the operation to suspend the system or to make it quiescent will be aborted. .SH RETURN VALUES .sp .ne 2 -.mk .na \fB\fBDDI_SUCCESS\fR\fR .ad .RS 15n -.rt For \fBDDI_DETACH\fR, the state associated with the given device was successfully removed. For \fBDDI_SUSPEND\fR, the driver was successfully suspended. @@ -141,12 +135,10 @@ suspended. .sp .ne 2 -.mk .na \fB\fBDDI_FAILURE\fR\fR .ad .RS 15n -.rt The operation failed or the request was not understood. The associated state is unchanged. .RE @@ -163,13 +155,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man9e/devmap.9e b/usr/src/man/man9e/devmap.9e index 3b53772c73..09a65be767 100644 --- a/usr/src/man/man9e/devmap.9e +++ b/usr/src/man/man9e/devmap.9e @@ -4,18 +4,18 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH devmap 9E "15 Jan 1997" "SunOS 5.11" "Driver Entry Points" +.TH DEVMAP 9E "Jan 15, 1997" .SH NAME devmap \- validate and translate virtual mapping for memory mapped device .SH SYNOPSIS .LP .nf -#include <sys/ddi.h> +#include <sys/ddi.h> #include <sys/sunddi.h> -\fBint prefix\fR\fBdevmap\fR(\fBdev_t\fR \fIdev\fR, \fBdevmap_cookie_t\fR \fIdhp\fR, \fBoffset_t\fR \fIoff\fR, +\fBint prefix\fR\fBdevmap\fR(\fBdev_t\fR \fIdev\fR, \fBdevmap_cookie_t\fR \fIdhp\fR, \fBoffset_t\fR \fIoff\fR, \fBsize_t\fR \fIlen\fR, \fBsize_t *\fR\fImaplen\fR, \fBuint_t\fR \fImodel\fR); .fi @@ -26,68 +26,56 @@ Solaris DDI specific (Solaris DDI). .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIdev\fR \fR .ad .RS 11n -.rt Device whose memory is to be mapped. .RE .sp .ne 2 -.mk .na \fB\fIdhp\fR \fR .ad .RS 11n -.rt An opaque mapping handle that the system uses to describe the mapping. .RE .sp .ne 2 -.mk .na \fB\fIoff\fR \fR .ad .RS 11n -.rt User offset within the logical device memory at which the mapping begins. .RE .sp .ne 2 -.mk .na \fB\fIlen\fR \fR .ad .RS 11n -.rt Length (in bytes) of the mapping to be mapped. .RE .sp .ne 2 -.mk .na \fB\fImaplen\fR \fR .ad .RS 11n -.rt Pointer to length (in bytes) of mapping that has been validated. \fImaplen\fR is less than or equal to \fIlen\fR. .RE .sp .ne 2 -.mk .na \fB\fImodel\fR \fR .ad .RS 11n -.rt The data model type of the current thread. .RE @@ -188,23 +176,19 @@ aligned with the kernel address being mapped for cache coherence. .SH RETURN VALUES .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 12n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fBNon-zero\fR .ad .RS 12n -.rt An error occurred. .RE @@ -231,7 +215,7 @@ made in the \fBdetach\fR(9E) routine to free up the kernel memory. .nf \&.\|.\|. #define MAPPING_SIZE 0x2000 /* size of the mapping */ -#define MAPPING_START 0x70000000 /* logical offset at beginning +#define MAPPING_START 0x70000000 /* logical offset at beginning of the mapping */ static struct devmap_callback_ctl xxmap_ops = { @@ -242,7 +226,7 @@ struct devmap_callback_ctl xxmap_ops = { xxmap_unmap, /* devmap_ops unmap routine */ }; - + static int xxdevmap(dev_t dev, devmap_cookie_t dhp, offset_t off, size_t len, size_t *maplen, uint_t model) @@ -289,11 +273,11 @@ xxdevmap(dev_t dev, devmap_cookie_t dhp, offset_t off, size_t len, if ((err = devmap_devmem_setup(dhp, dip, callbackops, rnumber, roff, length, maxprot, flags, endian_attr)) < 0) - + return (err); } else if (\fI off is referring to a kernel memory.\fR) { - cookie = xsp->cookie; /* cookie is obtained from + cookie = xsp->cookie; /* cookie is obtained from ddi_umem_alloc(9F) */ koff = XXX; /* offset within the kernel memory. */ callbackops = NULL; /* don't do callback for this mapping */ diff --git a/usr/src/man/man9e/devmap_access.9e b/usr/src/man/man9e/devmap_access.9e index a1d34105f2..47d4e9b630 100644 --- a/usr/src/man/man9e/devmap_access.9e +++ b/usr/src/man/man9e/devmap_access.9e @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH devmap_access 9E "17 Jan 1997" "SunOS 5.11" "Driver Entry Points" +.TH DEVMAP_ACCESS 9E "Jan 17, 1997" .SH NAME devmap_access \- device mapping access entry point .SH SYNOPSIS @@ -14,7 +14,7 @@ devmap_access \- device mapping access entry point -\fBint prefix\fR\fBdevmap_access\fR(\fBdevmap_cookie_t\fR \fIdhp\fR, \fBvoid *\fR\fIpvtp\fR, +\fBint prefix\fR\fBdevmap_access\fR(\fBdevmap_cookie_t\fR \fIdhp\fR, \fBvoid *\fR\fIpvtp\fR, \fBoffset_t\fR \fIoff\fR, \fBsize_t\fR \fIlen\fR, \fBuint_t\fR \fItype\fR, \fBuint_t\fR \fIrw\fR); .fi @@ -25,87 +25,71 @@ Solaris DDI specific (Solaris DDI). .SH ARGUMENTS .sp .ne 2 -.mk .na \fB\fIdhp\fR \fR .ad .RS 9n -.rt An opaque mapping handle that the system uses to describe the mapping. .RE .sp .ne 2 -.mk .na \fB\fIpvtp\fR \fR .ad .RS 9n -.rt Driver private mapping data. .RE .sp .ne 2 -.mk .na \fB\fIoff\fR \fR .ad .RS 9n -.rt User offset within the logical device memory at which the access begins. .RE .sp .ne 2 -.mk .na \fB\fIlen\fR \fR .ad .RS 9n -.rt Length (in bytes) of the memory being accessed. .RE .sp .ne 2 -.mk .na \fB\fItype\fR \fR .ad .RS 9n -.rt Type of access operation. Possible values are: .sp .ne 2 -.mk .na \fB\fBDEVMAP_ACCESS\fR \fR .ad .RS 18n -.rt Memory access. .RE .sp .ne 2 -.mk .na \fB\fBDEVMAP_LOCK\fR \fR .ad .RS 18n -.rt Lock the memory being accessed. .RE .sp .ne 2 -.mk .na \fB\fBDEVMAP_UNLOCK\fR \fR .ad .RS 18n -.rt Unlock the memory being accessed. .RE @@ -113,43 +97,35 @@ Unlock the memory being accessed. .sp .ne 2 -.mk .na \fB\fIrw\fR \fR .ad .RS 9n -.rt Direction of access. Possible values are: .sp .ne 2 -.mk .na \fB\fBDEVMAP_READ\fR \fR .ad .RS 17n -.rt Read access attempted. .RE .sp .ne 2 -.mk .na \fB\fBDEVMAP_WRITE\fR \fR .ad .RS 17n -.rt Write access attempted. .RE .sp .ne 2 -.mk .na \fB\fBDEVMAP_EXEC\fR \fR .ad .RS 17n -.rt Execution access attempted. .RE @@ -196,23 +172,19 @@ A non-zero return value from \fBdevmap_access()\fR may result in a \fBdevmap_access()\fR returns the following values: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 12n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fBNon-zero\fR .ad .RS 12n -.rt An error occurred. The return value from \fBdevmap_do_ctxmgt\fR(9F) or \fBdevmap_default_access\fR(9F) should be returned. .RE diff --git a/usr/src/man/man9e/devmap_contextmgt.9e b/usr/src/man/man9e/devmap_contextmgt.9e index c8be6828b4..2eda12f9a2 100644 --- a/usr/src/man/man9e/devmap_contextmgt.9e +++ b/usr/src/man/man9e/devmap_contextmgt.9e @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH devmap_contextmgt 9E "16 Jan 1997" "SunOS 5.11" "Driver Entry Points" +.TH DEVMAP_CONTEXTMGT 9E "Jan 16, 1997" .SH NAME devmap_contextmgt \- driver callback function for context management .SH SYNOPSIS @@ -14,7 +14,7 @@ devmap_contextmgt \- driver callback function for context management -\fBint\fR \fBdevmap_contextmgt\fR(\fBdevmap_cookie_t\fR \fIdhp\fR, \fBvoid *\fR\fIpvtp\fR, +\fBint\fR \fBdevmap_contextmgt\fR(\fBdevmap_cookie_t\fR \fIdhp\fR, \fBvoid *\fR\fIpvtp\fR, \fBoffset_t\fR \fIoff\fR, \fBsize_t\fR \fIlen\fR, \fBuint_t\fR \fItype\fR, \fBuint_t\fR \fIrw\fR); .fi @@ -25,87 +25,71 @@ Solaris DDI specific (Solaris DDI). .SH ARGUMENTS .sp .ne 2 -.mk .na \fB\fIdhp\fR \fR .ad .RS 9n -.rt An opaque mapping handle that the system uses to describe the mapping. .RE .sp .ne 2 -.mk .na \fB\fIpvtp\fR \fR .ad .RS 9n -.rt Driver private mapping data. .RE .sp .ne 2 -.mk .na \fB\fIoff\fR \fR .ad .RS 9n -.rt User offset within the logical device memory at which the access begins. .RE .sp .ne 2 -.mk .na \fB\fIlen\fR \fR .ad .RS 9n -.rt Length (in bytes) of the memory being accessed. .RE .sp .ne 2 -.mk .na \fB\fItype\fR \fR .ad .RS 9n -.rt Type of access operation. Possible values are: .sp .ne 2 -.mk .na \fB\fBDEVMAP_ACCESS\fR \fR .ad .RS 18n -.rt Memory access. .RE .sp .ne 2 -.mk .na \fB\fBDEVMAP_LOCK\fR \fR .ad .RS 18n -.rt Lock the memory being accessed. .RE .sp .ne 2 -.mk .na \fB\fBDEVMAP_UNLOCK\fR \fR .ad .RS 18n -.rt Unlock the memory being accessed. .RE @@ -113,32 +97,26 @@ Unlock the memory being accessed. .sp .ne 2 -.mk .na \fB\fIrw\fR \fR .ad .RS 9n -.rt Direction of access. Possible values are: .sp .ne 2 -.mk .na \fB\fBDEVMAP_READ\fR \fR .ad .RS 17n -.rt Read access attempted. .RE .sp .ne 2 -.mk .na \fB\fBDEVMAP_WRITE\fR \fR .ad .RS 17n -.rt Write access attempted. .RE @@ -187,23 +165,19 @@ the process. .SH RETURN VALUES .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 12n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fBNon-zero\fR .ad .RS 12n -.rt An error occurred. .RE diff --git a/usr/src/man/man9e/devmap_dup.9e b/usr/src/man/man9e/devmap_dup.9e index e2be810fd9..1225ba19bf 100644 --- a/usr/src/man/man9e/devmap_dup.9e +++ b/usr/src/man/man9e/devmap_dup.9e @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH devmap_dup 9E "21 Jan 1997" "SunOS 5.11" "Driver Entry Points" +.TH DEVMAP_DUP 9E "Jan 21, 1997" .SH NAME devmap_dup \- device mapping duplication entry point .SH SYNOPSIS @@ -14,7 +14,7 @@ devmap_dup \- device mapping duplication entry point -\fB int prefix\fR\fBdevmap_dup\fR(\fBdevmap_cookie_t\fR \fIdhp\fR, \fBvoid *\fR\fIpvtp\fR, +\fB int prefix\fR\fBdevmap_dup\fR(\fBdevmap_cookie_t\fR \fIdhp\fR, \fBvoid *\fR\fIpvtp\fR, \fBdevmap_cookie_t\fR \fInew_dhp\fR, \fBvoid **\fR\fInew_pvtp\fR); .fi @@ -25,47 +25,39 @@ Solaris DDI specific (Solaris DDI). .SH ARGUMENTS .sp .ne 2 -.mk .na \fB\fIdhp\fR \fR .ad .RS 13n -.rt An opaque mapping handle that the system uses to describe the mapping currently being duplicated. .RE .sp .ne 2 -.mk .na \fB\fIpvtp\fR \fR .ad .RS 13n -.rt Driver private mapping data for the mapping currently being duplicated. .RE .sp .ne 2 -.mk .na \fB\fInew_dhp\fR \fR .ad .RS 13n -.rt An opaque data structure that the system uses to describe the duplicated device mapping. .RE .sp .ne 2 -.mk .na \fB\fInew_pvtp\fR \fR .ad .RS 13n -.rt A pointer to be filled in by device drivers with the driver private mapping data for the duplicated device mapping. .RE @@ -88,23 +80,19 @@ operation such as \fBfork()\fR to fail. \fBdevmap_dup()\fR returns the following values: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 12n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fBNon-zero\fR .ad .RS 12n -.rt An error occurred. .RE diff --git a/usr/src/man/man9e/devmap_map.9e b/usr/src/man/man9e/devmap_map.9e index e94d758535..c458ab1e64 100644 --- a/usr/src/man/man9e/devmap_map.9e +++ b/usr/src/man/man9e/devmap_map.9e @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH devmap_map 9E "7 Jan 1997" "SunOS 5.11" "Driver Entry Points" +.TH DEVMAP_MAP 9E "Jan 7, 1997" .SH NAME devmap_map \- device mapping create entry point .SH SYNOPSIS @@ -14,7 +14,7 @@ devmap_map \- device mapping create entry point -\fBint prefix\fR\fBdevmap_map\fR(\fBdevmap_cookie_t\fR \fIdhp\fR, \fBdev_t\fR \fIdev\fR, +\fBint prefix\fR\fBdevmap_map\fR(\fBdevmap_cookie_t\fR \fIdhp\fR, \fBdev_t\fR \fIdev\fR, \fBuint_t\fR \fIflags\fR, \fBoffset_t\fR \fIoff\fR, \fBsize_t\fR \fIlen\fR, \fBvoid **\fR\fIpvtp\fR); .fi @@ -25,55 +25,45 @@ Solaris DDI specific (Solaris DDI). .SH ARGUMENTS .sp .ne 2 -.mk .na \fB\fIdhp\fR \fR .ad .RS 10n -.rt An opaque mapping handle that the system uses to describe the mapping currently being created. .RE .sp .ne 2 -.mk .na \fB\fIdev\fR \fR .ad .RS 10n -.rt The device whose memory is to be mapped. .RE .sp .ne 2 -.mk .na \fB\fIflags\fR \fR .ad .RS 10n -.rt Flags indicating type of mapping. Possible values are: .sp .ne 2 -.mk .na \fB\fBMAP_PRIVATE\fR \fR .ad .RS 16n -.rt Changes are private. .RE .sp .ne 2 -.mk .na \fB\fBMAP_SHARED\fR \fR .ad .RS 16n -.rt Changes should be shared. .RE @@ -81,34 +71,28 @@ Changes should be shared. .sp .ne 2 -.mk .na \fB\fIoff\fR \fR .ad .RS 10n -.rt User offset within the logical device memory at which the mapping begins. .RE .sp .ne 2 -.mk .na \fB\fIlen\fR \fR .ad .RS 10n -.rt Length (in bytes) of the memory to be mapped. .RE .sp .ne 2 -.mk .na \fB\fIpvtp\fR \fR .ad .RS 10n -.rt A pointer to be filled in by device drivers with the driver private mapping data. .RE @@ -155,23 +139,19 @@ example, a driver may allocate a memory region to store the device context if \fBdevmap_map()\fR returns the following values: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 12n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fBNon-zero\fR .ad .RS 12n -.rt An error occurred. .RE diff --git a/usr/src/man/man9e/devmap_unmap.9e b/usr/src/man/man9e/devmap_unmap.9e index 68a690e485..545a002603 100644 --- a/usr/src/man/man9e/devmap_unmap.9e +++ b/usr/src/man/man9e/devmap_unmap.9e @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH devmap_unmap 9E "21 Jan 1997" "SunOS 5.11" "Driver Entry Points" +.TH DEVMAP_UNMAP 9E "Jan 21, 1997" .SH NAME devmap_unmap \- device mapping unmap entry point .SH SYNOPSIS @@ -14,8 +14,8 @@ devmap_unmap \- device mapping unmap entry point -\fBvoid prefix\fR\fBdevmap_unmap\fR(\fBdevmap_cookie_t\fR \fIdhp\fR, \fBvoid *\fR\fIpvtp\fR, - \fBoffset_t\fR \fIoff\fR, \fBsize_t\fR\fIlen\fR, \fBdevmap_cookie_t\fR \fInew_dhp1\fR, +\fBvoid prefix\fR\fBdevmap_unmap\fR(\fBdevmap_cookie_t\fR \fIdhp\fR, \fBvoid *\fR\fIpvtp\fR, + \fBoffset_t\fR \fIoff\fR, \fBsize_t\fR\fIlen\fR, \fBdevmap_cookie_t\fR \fInew_dhp1\fR, \fBvoid **\fR\fInew_pvtp1\fR, \fBdevmap_cookie_t\fR\fInew_dhp2\fR, \fBvoid **\fR\fInew_pvtp2\fR); .fi @@ -26,68 +26,56 @@ Solaris DDI specific (Solaris DDI). .SH ARGUMENTS .sp .ne 2 -.mk .na \fB\fIdhp\fR \fR .ad .RS 14n -.rt An opaque mapping handle that the system uses to describe the mapping. .RE .sp .ne 2 -.mk .na \fB\fIpvtp\fR \fR .ad .RS 14n -.rt Driver private mapping data. .RE .sp .ne 2 -.mk .na \fB\fIoff\fR \fR .ad .RS 14n -.rt User offset within the logical device memory at which the unmapping begins. .RE .sp .ne 2 -.mk .na \fB\fIlen\fR \fR .ad .RS 14n -.rt Length (in bytes) of the memory being unmapped. .RE .sp .ne 2 -.mk .na \fB\fInew_dhp1\fR \fR .ad .RS 14n -.rt The opaque mapping handle that the system uses to describe the new region that ends at (\fIoff\fR - 1) . \fInew_dhp1\fR may be \fINULL\fR. .RE .sp .ne 2 -.mk .na \fB\fInew_pvtp1\fR \fR .ad .RS 14n -.rt A pointer to be filled in by the driver with the driver private mapping data for the new region that ends at (\fIoff\fR - 1); ignored if \fInew_dhp1\fR is \fINULL\fR. @@ -95,24 +83,20 @@ for the new region that ends at (\fIoff\fR - 1); ignored if \fInew_dhp1\fR is .sp .ne 2 -.mk .na \fB\fInew_dhp2\fR \fR .ad .RS 14n -.rt The opaque mapping handle that the system uses to describe the new region that begins at (\fIoff \fR + \fIlen\fR); \fInew_dhp2\fR may be \fINULL\fR. .RE .sp .ne 2 -.mk .na \fB\fInew_pvtp2\fR \fR .ad .RS 14n -.rt A pointer to be filled in by the driver with the driver private mapping data for the new region that begins at (\fIoff\fR + \fIlen\fR); ignored if \fInew_dhp2\fR is \fINULL\fR. diff --git a/usr/src/man/man9e/dump.9e b/usr/src/man/man9e/dump.9e index d11ffa77a2..9d35b0dce0 100644 --- a/usr/src/man/man9e/dump.9e +++ b/usr/src/man/man9e/dump.9e @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH dump 9E "9 Oct 2001" "SunOS 5.11" "Driver Entry Points" +.TH DUMP 9E "Oct 9, 2001" .SH NAME dump \- dump memory to device during system failure .SH SYNOPSIS @@ -26,45 +26,37 @@ that do not implement \fBdump()\fR routines, \fBnodev\fR(9F) should be used. .SH ARGUMENTS .sp .ne 2 -.mk .na \fB\fIdev\fR \fR .ad .RS 10n -.rt Device number. .RE .sp .ne 2 -.mk .na \fB\fIaddr\fR \fR .ad .RS 10n -.rt Address for the beginning of the area to be dumped. .RE .sp .ne 2 -.mk .na \fB\fIblkno\fR \fR .ad .RS 10n -.rt Block offset to dump memory. .RE .sp .ne 2 -.mk .na \fB\fInblk\fR \fR .ad .RS 10n -.rt Number of blocks to dump. .RE diff --git a/usr/src/man/man9e/getinfo.9e b/usr/src/man/man9e/getinfo.9e index bb80b58ec2..cb766ccee0 100644 --- a/usr/src/man/man9e/getinfo.9e +++ b/usr/src/man/man9e/getinfo.9e @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH getinfo 9E "16 Jan 2008" "SunOS 5.11" "Driver Entry Points" +.TH GETINFO 9E "Jan 16, 2008" .SH NAME getinfo \- get device driver information .SH SYNOPSIS @@ -14,7 +14,7 @@ getinfo \- get device driver information -\fBint prefix\fR\fBgetinfo\fR(\fBdev_info_t *\fR\fIdip\fR, \fBddi_info_cmd_t\fR \fIcmd\fR, +\fBint prefix\fR\fBgetinfo\fR(\fBdev_info_t *\fR\fIdip\fR, \fBddi_info_cmd_t\fR \fIcmd\fR, \fBvoid *\fR\fIarg\fR, \fBvoid **\fR\fIresultp\fR); .fi @@ -26,46 +26,38 @@ drivers which export \fBcb_ops\fR(9S) entry points. .SH ARGUMENTS .sp .ne 2 -.mk .na \fB\fIdip\fR\fR .ad .RS 11n -.rt Do not use. .RE .sp .ne 2 -.mk .na \fB\fIcmd\fR\fR .ad .RS 11n -.rt Command argument - valid command values are \fBDDI_INFO_DEVT2DEVINFO\fR and \fBDDI_INFO_DEVT2INSTANCE\fR. .RE .sp .ne 2 -.mk .na \fB\fIarg\fR\fR .ad .RS 11n -.rt Command specific argument. .RE .sp .ne 2 -.mk .na \fB\fIresultp\fR\fR .ad .RS 11n -.rt Pointer to where the requested information is stored. .RE @@ -94,23 +86,19 @@ provide a \fBgetinfo()\fR entry point, and may use \fBnodev\fR(9F) in the \fBgetinfo()\fR should return: .sp .ne 2 -.mk .na \fB\fBDDI_SUCCESS\fR\fR .ad .RS 15n -.rt on success. .RE .sp .ne 2 -.mk .na \fB\fBDDI_FAILURE\fR\fR .ad .RS 15n -.rt on failure. .RE @@ -120,7 +108,7 @@ on failure. .sp .in +2 .nf -/*ARGSUSED*/ +/*ARGSUSED*/ static int rd_getinfo(dev_info_t *dip, ddi_info_cmd_t infocmd, void *arg, \e void **resultp) @@ -128,7 +116,7 @@ void **resultp) /* Note that in this simple example * the minor number is the instance * number. */ - + devstate_t *sp; int error = DDI_FAILURE; switch (infocmd) { diff --git a/usr/src/man/man9e/gld.9e b/usr/src/man/man9e/gld.9e index 23aad25060..7e6c463634 100644 --- a/usr/src/man/man9e/gld.9e +++ b/usr/src/man/man9e/gld.9e @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH gld 9E "3 Jan 2001" "SunOS 5.11" "Driver Entry Points" +.TH GLD 9E "Jan 3, 2001" .SH NAME gld, gldm_reset, gldm_start, gldm_stop, gldm_set_mac_addr, gldm_set_multicast, gldm_set_promiscuous, gldm_send, gldm_intr, gldm_get_stats, gldm_ioctl \- @@ -48,7 +48,7 @@ Generic LAN Driver entry points .LP .nf -\fBint\fR \fBprefix_send\fR(\fBgld_mac_info_t *\fR\fImacinfo\fR, +\fBint\fR \fBprefix_send\fR(\fBgld_mac_info_t *\fR\fImacinfo\fR, \fBmblk_t *\fR\fImp\fR); .fi @@ -59,13 +59,13 @@ Generic LAN Driver entry points .LP .nf -\fBint\fR \fBprefix_get_stats\fR(\fBgld_mac_info_t *\fR\fImacinfo\fR, +\fBint\fR \fBprefix_get_stats\fR(\fBgld_mac_info_t *\fR\fImacinfo\fR, \fBstruct gld_stats *\fR\fIstats\fR); .fi .LP .nf -\fBint\fR \fBprefix_ioctl\fR(\fBgld_mac_info_t *\fR\fImacinfo\fR, +\fBint\fR \fBprefix_ioctl\fR(\fBgld_mac_info_t *\fR\fImacinfo\fR, \fBqueue_t *\fR\fIq\fR, \fBmblk_t *\fR\fImp\fR); .fi @@ -76,23 +76,19 @@ Solaris architecture specific (Solaris DDI). .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fImacinfo\fR \fR .ad .RS 18n -.rt Pointer to a \fBgld_mac_info\fR(9S) structure. .RE .sp .ne 2 -.mk .na \fB\fImacaddr\fR \fR .ad .RS 18n -.rt Pointer to the beginning of a character array containing a valid MAC address. The array will be of the length specified by the driver in the \fBgldm_addrlen\fR element of the \fBgld_mac_info\fR(9S) structure. @@ -100,12 +96,10 @@ The array will be of the length specified by the driver in the .sp .ne 2 -.mk .na \fB\fImulticastaddr\fR \fR .ad .RS 18n -.rt Pointer to the beginning of a character array containing a multicast, group, or functional address. The array will be of the length specified by the driver in the \fBgldm_addrlen\fR element of the \fBgld_mac_info\fR(9S) structure. @@ -113,12 +107,10 @@ the \fBgldm_addrlen\fR element of the \fBgld_mac_info\fR(9S) structure. .sp .ne 2 -.mk .na \fB\fImultiflag\fR \fR .ad .RS 18n -.rt A flag indicating whether reception of the multicast address is to be enabled or disabled. This argument is specified as \fBGLD_MULTI_ENABLE\fR or \fBGLD_MULTI_DISABLE\fR. @@ -126,12 +118,10 @@ or disabled. This argument is specified as \fBGLD_MULTI_ENABLE\fR or .sp .ne 2 -.mk .na \fB\fIpromiscflag\fR \fR .ad .RS 18n -.rt A flag indicating what type of promiscuous mode, if any, is to be enabled. This argument is specified as \fBGLD_MAC_PROMISC_PHYS\fR, \fBGLD_MAC_PROMISC_MULTI\fR, or \fBGLD_MAC_PROMISC_NONE\fR. @@ -139,36 +129,30 @@ argument is specified as \fBGLD_MAC_PROMISC_PHYS\fR, .sp .ne 2 -.mk .na \fB\fImp\fR \fR .ad .RS 18n -.rt Pointer to a STREAMS message block containing the packet to be transmitted or the ioctl to be executed. .RE .sp .ne 2 -.mk .na \fB\fIstats\fR \fR .ad .RS 18n -.rt Pointer to a \fBgld_stats\fR(9S) structure to be filled in with the current values of statistics counters. .RE .sp .ne 2 -.mk .na \fB\fIq\fR \fR .ad .RS 18n -.rt Pointer to the \fBqueue\fR(9S) structure to be used in the reply to the ioctl. .RE @@ -347,23 +331,19 @@ an error of \fBEINVAL\fR. \fBgldm_intr\fR(\|) must return: .sp .ne 2 -.mk .na \fB\fBDDI_INTR_CLAIMED\fR \fR .ad .RS 23n -.rt if and only if the device definitely interrupted. .RE .sp .ne 2 -.mk .na \fB\fBDDI_INTR_UNCLAIMED\fR \fR .ad .RS 23n -.rt if the device did not interrupt. .RE @@ -372,24 +352,20 @@ if the device did not interrupt. The other functions must return: .sp .ne 2 -.mk .na \fB\fBGLD_SUCCESS\fR \fR .ad .RS 21n -.rt on success. \fBgldm_stop\fR(\|) and \fBgldm_ioctl\fR(\|) should always return this value. .RE .sp .ne 2 -.mk .na \fB\fBGLD_NORESOURCES\fR \fR .ad .RS 21n -.rt if there are insufficient resources to carry out the request at this time. Only \fBgldm_set_mac_addr\fR(\|), \fBgldm_set_multicast\fR(\|), \fBgldm_set_promiscuous\fR(\|), and \fBgldm_send\fR(\|) may return this value. @@ -397,24 +373,20 @@ if there are insufficient resources to carry out the request at this time. Only .sp .ne 2 -.mk .na \fB\fBGLD_NOLINK\fR \fR .ad .RS 21n -.rt if \fBgldm_send\fR(\|) is called when there is no physical connection to a network or link partner. .RE .sp .ne 2 -.mk .na \fB\fBGLD_NOTSUPPORTED\fR \fR .ad .RS 21n -.rt if the requested function is not supported. Only \fBgldm_set_mac_addr\fR(\|), \fBgldm_set_multicast\fR(\|), and \fBgldm_set_promiscuous\fR(\|) may return this value. @@ -422,24 +394,20 @@ this value. .sp .ne 2 -.mk .na \fB\fBGLD_BADARG\fR \fR .ad .RS 21n -.rt if the function detected an unsuitable argument, for example, a bad multicast address, a bad MAC address, or a bad packet or packet length. .RE .sp .ne 2 -.mk .na \fB\fBGLD_FAILURE\fR \fR .ad .RS 21n -.rt on hardware failure. .RE diff --git a/usr/src/man/man9e/identify.9e b/usr/src/man/man9e/identify.9e index 3fd8ee4ffd..f60b571443 100644 --- a/usr/src/man/man9e/identify.9e +++ b/usr/src/man/man9e/identify.9e @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH identify 9E "11 Apr 2003" "SunOS 5.11" "Driver Entry Points" +.TH IDENTIFY 9E "Apr 11, 2003" .SH NAME identify \- determine if a driver is associated with a device .SH INTERFACE LEVEL @@ -23,13 +23,12 @@ See \fBattributes\fR(5) for a description of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -\fBATTRIBUTE TYPE\fR\fBATTRIBUTE VALUE\fR +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Stability LevelObsolete +Stability Level Obsolete .TE .SH WARNING diff --git a/usr/src/man/man9e/ioctl.9e b/usr/src/man/man9e/ioctl.9e index 710dd3f250..afb43407d0 100644 --- a/usr/src/man/man9e/ioctl.9e +++ b/usr/src/man/man9e/ioctl.9e @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH ioctl 9E "3 Dec 1996" "SunOS 5.11" "Driver Entry Points" +.TH IOCTL 9E "Dec 3, 1996" .SH NAME ioctl \- control a character device .SH SYNOPSIS @@ -18,7 +18,7 @@ ioctl \- control a character device -\fBint prefix\fR\fBioctl\fR(\fBdev_t\fR \fIdev\fR, \fBint\fR \fIcmd\fR, \fBintptr_t\fR \fIarg\fR, \fBint\fR \fImode\fR, +\fBint prefix\fR\fBioctl\fR(\fBdev_t\fR \fIdev\fR, \fBint\fR \fIcmd\fR, \fBintptr_t\fR \fIarg\fR, \fBint\fR \fImode\fR, \fBcred_t *\fR\fIcred_p\fR, \fBint *\fR\fIrval_p\fR); .fi @@ -29,35 +29,29 @@ Architecture independent level 1 (DDI/DKI). This entry point is \fBoptional\fR. .SH ARGUMENTS .sp .ne 2 -.mk .na \fB\fIdev\fR\fR .ad .RS 10n -.rt Device number. .RE .sp .ne 2 -.mk .na \fB\fIcmd\fR\fR .ad .RS 10n -.rt Command argument the driver \fBioctl()\fR routine interprets as the operation to be performed. .RE .sp .ne 2 -.mk .na \fB\fIarg\fR\fR .ad .RS 10n -.rt Passes parameters between a user program and the driver. When used with terminals, the argument is the address of a user program structure containing driver or hardware settings. Alternatively, the argument may be a value that @@ -68,12 +62,10 @@ interpret the argument. .sp .ne 2 -.mk .na \fB\fImode\fR\fR .ad .RS 10n -.rt A bit field that contains: .RS +4 .TP @@ -102,23 +94,19 @@ See below. .sp .ne 2 -.mk .na \fB\fIcred_p\fR\fR .ad .RS 10n -.rt Pointer to the user credential structure. .RE .sp .ne 2 -.mk .na \fB\fIrval_p\fR\fR .ad .RS 10n -.rt Pointer to return value for calling process. The driver may elect to set the value which is valid only if the \fBioctl()\fR succeeds. .RE @@ -237,22 +225,22 @@ struct passargs32 { int len; caddr32_t addr; }; - + struct passargs { int len; caddr_t addr; }; - + xxioctl(dev_t dev, int cmd, intptr_t arg, int mode, cred_t *credp, int *rvalp) { struct passargs pa; - + #ifdef _MULTI_DATAMODEL switch (ddi_model_convert_from(mode & FMODELS)) { case DDI_MODEL_ILP32: { struct passargs32 pa32; - + ddi_copyin(arg, &pa32, sizeof (struct passargs32),\e mode); pa.len = pa32.len; @@ -267,7 +255,7 @@ xxioctl(dev_t dev, int cmd, intptr_t arg, int mode, #else /* _MULTI_DATAMODEL */ ddi_copyin(arg, &pa, sizeof (struct passargs), mode); #endif /* _MULTI_DATAMODEL */ - + do_ioctl(&pa); .\|.\|.\|. } diff --git a/usr/src/man/man9e/ks_snapshot.9e b/usr/src/man/man9e/ks_snapshot.9e index 3d62faefdf..f096a67557 100644 --- a/usr/src/man/man9e/ks_snapshot.9e +++ b/usr/src/man/man9e/ks_snapshot.9e @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH ks_snapshot 9E "4 Dec 2002" "SunOS 5.11" "Driver Entry Points" +.TH KS_SNAPSHOT 9E "Dec 4, 2002" .SH NAME ks_snapshot \- take a snapshot of kstat data .SH SYNOPSIS @@ -26,54 +26,44 @@ Solaris DDI specific (Solaris DDI). .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIksp\fR \fR .ad .RS 8n -.rt Pointer to a \fBkstat\fR(9S) structure. .RE .sp .ne 2 -.mk .na \fB\fIbuf\fR \fR .ad .RS 8n -.rt Pointer to a buffer to copy the snapshot into. .RE .sp .ne 2 -.mk .na \fB\fIrw\fR \fR .ad .RS 8n -.rt Read/Write flag. Possible values are: .sp .ne 2 -.mk .na \fB\fBKSTAT_READ\fR\fR .ad .RS 15n -.rt Copy driver statistics from the driver to the buffer. .RE .sp .ne 2 -.mk .na \fB\fBKSTAT_WRITE\fR\fR .ad .RS 15n -.rt Copy statistics from the buffer to the driver. .RE @@ -135,34 +125,28 @@ from the buffer to the \fBkstat\fR on \fBKSTAT_WRITE\fR. .SH RETURN VALUES .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 10n -.rt Success .RE .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 10n -.rt If \fBKSTAT_WRITE\fR is not allowed .RE .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 10n -.rt For any other error .RE @@ -199,7 +183,7 @@ xxx_kstat_snapshot(kstat_t *ksp, void *buf, int rw) KSTAT_NAMED_STR_BUFLEN(knp)); KSTAT_NAMED_STR_PTR(knp) = end; end += KSTAT_NAMED_STR_BUFLEN(knp); - } + } } return (0); } diff --git a/usr/src/man/man9e/ks_update.9e b/usr/src/man/man9e/ks_update.9e index ebbb410a1b..4b3865742a 100644 --- a/usr/src/man/man9e/ks_update.9e +++ b/usr/src/man/man9e/ks_update.9e @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH ks_update 9E "27 May 1994" "SunOS 5.11" "Driver Entry Points" +.TH KS_UPDATE 9E "May 27, 1994" .SH NAME ks_update \- dynamically update kstats .SH SYNOPSIS @@ -26,43 +26,35 @@ Solaris DDI specific (Solaris DDI) .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIksp\fR \fR .ad .RS 8n -.rt Pointer to a \fBkstat\fR(9S) structure. .RE .sp .ne 2 -.mk .na \fB\fIrw\fR \fR .ad .RS 8n -.rt Read/Write flag. Possible values are .sp .ne 2 -.mk .na \fB\fBKSTAT_READ\fR \fR .ad .RS 16n -.rt Update \fBkstat\fR structure statistics from the driver. .RE .sp .ne 2 -.mk .na \fB\fBKSTAT_WRITE\fR \fR .ad .RS 16n -.rt Update driver statistics from the kstat structure. .RE @@ -115,34 +107,28 @@ consistent data) and will prevent the \fBkstat\fR from being removed. \fBks_update()\fR should return .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 11n -.rt For success. .RE .sp .ne 2 -.mk .na \fB\fBEACCES\fR \fR .ad .RS 11n -.rt If \fBKSTAT_WRITE\fR is not allowed. .RE .sp .ne 2 -.mk .na \fB\fBEIO\fR \fR .ad .RS 11n -.rt For any other error. .RE diff --git a/usr/src/man/man9e/mmap.9e b/usr/src/man/man9e/mmap.9e index d19a087a04..3af5e20b98 100644 --- a/usr/src/man/man9e/mmap.9e +++ b/usr/src/man/man9e/mmap.9e @@ -1,10 +1,10 @@ '\" te -.\" Copyright 1989 AT&T +.\" Copyright 1989 AT&T .\" Copyright (c) 2002, Sun Microsystems, Inc. All Rights Reserved .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH mmap 9E "27 Sep 2002" "SunOS 5.11" "Driver Entry Points" +.TH MMAP 9E "Sep 27, 2002" .SH NAME mmap \- check virtual mapping for memory mapped device .SH SYNOPSIS @@ -27,88 +27,72 @@ This interface is obsolete. \fBdevmap\fR(9E) should be used instead. .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIdev\fR \fR .ad .RS 9n -.rt Device whose memory is to be mapped. .RE .sp .ne 2 -.mk .na \fB\fIoff\fR \fR .ad .RS 9n -.rt Offset within device memory at which mapping begins. .RE .sp .ne 2 -.mk .na \fB\fIprot\fR \fR .ad .RS 9n -.rt A bit field that specifies the protections this page of memory will receive. Possible settings are: .sp .ne 2 -.mk .na \fB\fBPROT_READ\fR \fR .ad .RS 15n -.rt Read access will be granted. .RE .sp .ne 2 -.mk .na \fB\fBPROT_WRITE\fR \fR .ad .RS 15n -.rt Write access will be granted. .RE .sp .ne 2 -.mk .na \fB\fBPROT_EXEC\fR \fR .ad .RS 15n -.rt Execute access will be granted. .RE .sp .ne 2 -.mk .na \fB\fBPROT_USER\fR \fR .ad .RS 15n -.rt User-level access will be granted. .RE .sp .ne 2 -.mk .na \fB\fBPROT_ALL\fR \fR .ad .RS 15n -.rt All access will be granted. .RE @@ -211,7 +195,7 @@ static int xxmmap(dev_t dev, off_t off, int prot) { int instance; - struct xxstate *xsp; + struct xxstate *xsp; /* No write access */ if (prot & PROT_WRITE) @@ -238,13 +222,12 @@ See \fBattributes\fR(5) for a description of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -\fBATTRIBUTE TYPE\fR\fBATTRIBUTE VALUE\fR +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Stability LevelObsolete +Stability Level Obsolete .TE .SH SEE ALSO diff --git a/usr/src/man/man9e/open.9e b/usr/src/man/man9e/open.9e index 9d73b7d4c0..94ac13d2d3 100644 --- a/usr/src/man/man9e/open.9e +++ b/usr/src/man/man9e/open.9e @@ -4,7 +4,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH open 9E "24 Apr 2008" "SunOS 5.11" "Driver Entry Points" +.TH OPEN 9E "Apr 24, 2008" .SH NAME open \- gain access to a device .SH SYNOPSIS @@ -21,7 +21,7 @@ open \- gain access to a device -\fBint prefix\fR\fBopen\fR(\fBdev_t *\fR\fIdevp\fR, \fBint\fR \fIflag\fR, \fBint\fR \fIotyp\fR, +\fBint prefix\fR\fBopen\fR(\fBdev_t *\fR\fIdevp\fR, \fBint\fR \fIflag\fR, \fBint\fR \fIotyp\fR, \fBcred_t *\fR\fIcred_p\fR); .fi @@ -35,7 +35,7 @@ open \- gain access to a device -\fBint prefix\fR\fBopen\fR(\fBqueue_t *\fR\fIq\fR, \fBdev_t *\fR\fIdevp\fR, \fBint\fR \fIoflag\fR, \fBint\fR \fIsflag\fR, +\fBint prefix\fR\fBopen\fR(\fBqueue_t *\fR\fIq\fR, \fBdev_t *\fR\fIdevp\fR, \fBint\fR \fIoflag\fR, \fBint\fR \fIsflag\fR, \fBcred_t *\fR\fIcred_p\fR); .fi @@ -48,69 +48,57 @@ it can be \fBnulldev\fR(9F) .SS "Block and Character" .sp .ne 2 -.mk .na \fB\fIdevp\fR\fR .ad .RS 10n -.rt Pointer to a device number. .RE .sp .ne 2 -.mk .na \fB\fIflag\fR\fR .ad .RS 10n -.rt A bit field passed from the user program \fBopen\fR(2) system call that instructs the driver on how to open the file. Valid settings are: .sp .ne 2 -.mk .na \fB\fBFEXCL\fR\fR .ad .RS 11n -.rt Open the device with exclusive access; fail all other attempts to open the device. .RE .sp .ne 2 -.mk .na \fB\fBFNDELAY\fR\fR .ad .RS 11n -.rt Open the device and return immediately. Do not block the open even if something is wrong. .RE .sp .ne 2 -.mk .na \fB\fBFREAD\fR\fR .ad .RS 11n -.rt Open the device with read-only permission, If \fBOR\fRed with \fBFWRITE\fR, allow both read and write access. .RE .sp .ne 2 -.mk .na \fB\fBFWRITE\fR\fR .ad .RS 11n -.rt Open a device with write-only permission. If ORed with \fBFREAD\fR, allow both read and write access. .RE @@ -119,12 +107,10 @@ read and write access. .sp .ne 2 -.mk .na \fB\fIotyp\fR\fR .ad .RS 10n -.rt Parameter supplied for driver to determine how many times a device was opened and for what reasons. For \fBOTYP_BLK\fR and \fBOTYP_CHR\fR, the \fBopen()\fR function can be called many times, but the \fBclose\fR(9E) function is called @@ -137,34 +123,28 @@ This permits software drivers to exist above hardware drivers and removes any ambiguity from the hardware driver regarding how a device is used. .sp .ne 2 -.mk .na \fB\fBOTYP_BLK\fR\fR .ad .RS 12n -.rt Open occurred through block interface for the device. .RE .sp .ne 2 -.mk .na \fB\fBOTYP_CHR\fR\fR .ad .RS 12n -.rt Open occurred through the raw/character interface for the device. .RE .sp .ne 2 -.mk .na \fB\fBOTYP_LYR\fR\fR .ad .RS 12n -.rt Open a layered process. This flag is used when one driver calls another driver's \fBopen()\fR or \fBclose\fR(9E) function. The calling driver ensures that there is one-layered close for each layered open. This flag applies to @@ -175,35 +155,29 @@ both block and character devices. .sp .ne 2 -.mk .na \fB\fIcred_p\fR\fR .ad .RS 10n -.rt Pointer to the user credential structure. .RE .SS "STREAMS" .sp .ne 2 -.mk .na \fB\fIq\fR\fR .ad .RS 10n -.rt A pointer to the read \fBqueue\fR. .RE .sp .ne 2 -.mk .na \fB\fIdevp\fR\fR .ad .RS 10n -.rt Pointer to a device number. For \fBSTREAMS \fRmodules, \fIdevp\fR always points to the device number associated with the driver at the end (tail) of the stream. @@ -211,12 +185,10 @@ stream. .sp .ne 2 -.mk .na \fB\fIoflag\fR\fR .ad .RS 10n -.rt Valid \fIoflag\fR values are \fBFEXCL\fR, \fBFNDELAY\fR, \fBFREAD\fR, and \fBFWRITEL\fR \(em the same as those listed above for \fIflag.\fR. For \fBSTREAMS\fR modules, \fIoflag\fR is always set to \fB0\fR. @@ -224,33 +196,27 @@ Valid \fIoflag\fR values are \fBFEXCL\fR, \fBFNDELAY\fR, \fBFREAD\fR, and .sp .ne 2 -.mk .na \fB\fIsflag\fR\fR .ad .RS 10n -.rt Valid values are as follows: .sp .ne 2 -.mk .na \fB\fBCLONEOPEN\fR\fR .ad .RS 13n -.rt Indicates that the \fBopen()\fR function is called through the clone driver. The driver should return a unique device number. .RE .sp .ne 2 -.mk .na \fB\fBMODOPEN\fR\fR .ad .RS 13n -.rt Modules should be called with \fIsflag\fR set to this value. Modules should return an error if they are called with \fIsflag\fR set to a different value. Drivers should return an error if they are called with \fIsflag\fR set to this @@ -259,12 +225,10 @@ value. .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 13n -.rt Indicates a driver is opened directly, without calling the clone driver. .RE @@ -272,12 +236,10 @@ Indicates a driver is opened directly, without calling the clone driver. .sp .ne 2 -.mk .na \fB\fIcred_p\fR\fR .ad .RS 10n -.rt Pointer to the user credential structure. .RE diff --git a/usr/src/man/man9e/power.9e b/usr/src/man/man9e/power.9e index ce53db2070..63da04546e 100644 --- a/usr/src/man/man9e/power.9e +++ b/usr/src/man/man9e/power.9e @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH power 9E "12 Dec 2003" "SunOS 5.11" "Driver Entry Points" +.TH POWER 9E "Dec 12, 2003" .SH NAME power \- power a device attached to the system .SH SYNOPSIS @@ -26,34 +26,28 @@ the \fBcb_ops\fR(9S) structure instead. .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIdip\fR\fR .ad .RS 13n -.rt Pointer to the device's \fBdev_info\fR structure. .RE .sp .ne 2 -.mk .na \fB\fIcomponent\fR\fR .ad .RS 13n -.rt Component of the driver to be managed. .RE .sp .ne 2 -.mk .na \fB\fIlevel\fR\fR .ad .RS 13n -.rt Desired component power level. .RE @@ -96,23 +90,19 @@ power level should not be changed and power should return \fBDDI_FAILURE\fR. The \fBpower()\fR function returns: .sp .ne 2 -.mk .na \fB\fBDDI_SUCCESS\fR\fR .ad .RS 15n -.rt Successfully set the power to the requested \fIlevel\fR. .RE .sp .ne 2 -.mk .na \fB\fBDDI_FAILURE\fR\fR .ad .RS 15n -.rt Failed to set the power to the requested \fIlevel\fR. .RE @@ -128,13 +118,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface stabilityCommitted +Interface stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man9e/print.9e b/usr/src/man/man9e/print.9e index fcd917aecb..182ca3e079 100644 --- a/usr/src/man/man9e/print.9e +++ b/usr/src/man/man9e/print.9e @@ -1,10 +1,10 @@ '\" te .\" Copyright 1989 AT&T -.\" Copyright (c) 1997, Sun Microsystems, Inc., All Rights Reserved +.\" Copyright (c) 1997, Sun Microsystems, Inc., All Rights Reserved .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH print 9E "15 Sep 1992" "SunOS 5.11" "Driver Entry Points" +.TH PRINT 9E "Sep 15, 1992" .SH NAME print \- display a driver message on system console .SH SYNOPSIS @@ -28,23 +28,19 @@ block devices. .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIdev\fR \fR .ad .RS 8n -.rt Device number. .RE .sp .ne 2 -.mk .na \fB\fIstr\fR \fR .ad .RS 8n -.rt Pointer to a character string describing the problem. .RE diff --git a/usr/src/man/man9e/probe.9e b/usr/src/man/man9e/probe.9e index 73f639c82e..d7c6e352bb 100644 --- a/usr/src/man/man9e/probe.9e +++ b/usr/src/man/man9e/probe.9e @@ -4,7 +4,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH probe 9E "18 Nov 1992" "SunOS 5.11" "Driver Entry Points" +.TH PROBE 9E "Nov 18, 1992" .SH NAME probe \- determine if a non-self-identifying device is present .SH SYNOPSIS @@ -29,12 +29,10 @@ self-identifying devices, \fBnulldev\fR(9F) should be specified in the .SH ARGUMENTS .sp .ne 2 -.mk .na \fB\fIdip\fR \fR .ad .RS 8n -.rt Pointer to the device's \fBdev_info\fR structure. .RE @@ -71,45 +69,37 @@ needs to do any work. See \fBddi_dev_is_sid\fR(9F) for an example. .SH RETURN VALUES .sp .ne 2 -.mk .na \fB\fBDDI_PROBE_SUCCESS\fR \fR .ad .RS 23n -.rt If the probe was successful. .RE .sp .ne 2 -.mk .na \fB\fBDDI_PROBE_FAILURE\fR \fR .ad .RS 23n -.rt If the probe failed. .RE .sp .ne 2 -.mk .na \fB\fBDDI_PROBE_DONTCARE\fR \fR .ad .RS 23n -.rt If the probe was unsuccessful, yet \fBattach\fR(9E) should still be called. .RE .sp .ne 2 -.mk .na \fB\fBDDI_PROBE_PARTIAL\fR \fR .ad .RS 23n -.rt If the instance is not present now, but may be present in the future. .RE diff --git a/usr/src/man/man9e/prop_op.9e b/usr/src/man/man9e/prop_op.9e index bb9d965b7f..904c19be01 100644 --- a/usr/src/man/man9e/prop_op.9e +++ b/usr/src/man/man9e/prop_op.9e @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH prop_op 9E "8 Jul 1996" "SunOS 5.11" "Driver Entry Points" +.TH PROP_OP 9E "Jul 8, 1996" .SH NAME prop_op \- report driver property information .SH SYNOPSIS @@ -15,8 +15,8 @@ prop_op \- report driver property information -\fBint prefix\fR\fBprop_op\fR(\fBdev_t\fR \fIdev\fR, \fBdev_info_t *\fR\fIdip\fR, - \fBddi_prop_op_t\fR \fIprop_op\fR, \fBint\fR \fIflags\fR, \fBchar *\fR\fIname\fR, \fBcaddr_t\fR \fIvaluep\fR, +\fBint prefix\fR\fBprop_op\fR(\fBdev_t\fR \fIdev\fR, \fBdev_info_t *\fR\fIdip\fR, + \fBddi_prop_op_t\fR \fIprop_op\fR, \fBint\fR \fIflags\fR, \fBchar *\fR\fIname\fR, \fBcaddr_t\fR \fIvaluep\fR, \fBint *\fR\fIlengthp\fR); .fi @@ -28,65 +28,53 @@ Solaris DDI specific (Solaris DDI). This entry point is required, but it can be .SH ARGUMENTS .sp .ne 2 -.mk .na \fB\fIdev\fR\fR .ad .RS 12n -.rt Device number associated with this device. .RE .sp .ne 2 -.mk .na \fB\fIdip\fR\fR .ad .RS 12n -.rt A pointer to the device information structure for this device. .RE .sp .ne 2 -.mk .na \fB\fIprop_op\fR\fR .ad .RS 12n -.rt Property operator. Valid operators are: .sp .ne 2 -.mk .na \fB\fBPROP_LEN\fR \fR .ad .RS 26n -.rt Get property length only. (\fIvaluep\fR unaffected). .RE .sp .ne 2 -.mk .na \fB\fBPROP_LEN_AND_VAL_BUF\fR\fR .ad .RS 26n -.rt Get length and value into caller's buffer. (\fIvaluep\fR used as input). .RE .sp .ne 2 -.mk .na \fB\fBPROP_LEN_AND_VAL_ALLOC\fR\fR .ad .RS 26n -.rt Get length and value into allocated buffer. (\fIvaluep\fR returned as pointer to pointer to allocated buffer). .RE @@ -95,21 +83,17 @@ to pointer to allocated buffer). .sp .ne 2 -.mk .na \fB\fIflags\fR\fR .ad .RS 12n -.rt The only possible flag value is: .sp .ne 2 -.mk .na \fB\fBDDI_PROP_DONTPASS\fR\fR .ad .RS 21n -.rt Do not pass request to parent if property not found. .RE @@ -117,23 +101,19 @@ Do not pass request to parent if property not found. .sp .ne 2 -.mk .na \fB\fIname\fR\fR .ad .RS 12n -.rt Pointer to name of property to be interrogated. .RE .sp .ne 2 -.mk .na \fB\fIvaluep\fR \fR .ad .RS 12n -.rt If \fIprop_op\fR is \fBPROP_LEN_AND_VAL_BUF\fR, this should be a pointer to the user's buffer. If \fIprop_op\fR is \fBPROP_LEN_AND_VAL_ALLOC\fR, this should be the \fIaddress\fR of a pointer. @@ -141,12 +121,10 @@ should be the \fIaddress\fR of a pointer. .sp .ne 2 -.mk .na \fB\fIlengthp\fR \fR .ad .RS 12n -.rt On exit, *\fIlengthp\fR will contain the property length. If \fIprop_op\fR is \fBPROP_LEN_AND_VAL_BUF\fR then \fIlengthp\fR should point to an \fBint\fR that contains the length of caller's buffer, before calling \fBprop_op()\fR. @@ -167,57 +145,47 @@ properties for its device. \fBprop_op()\fR should return: .sp .ne 2 -.mk .na \fB\fBDDI_PROP_SUCCESS\fR \fR .ad .RS 27n -.rt Property found and returned. .RE .sp .ne 2 -.mk .na \fB\fBDDI_PROP_NOT_FOUND\fR \fR .ad .RS 27n -.rt Property not found. .RE .sp .ne 2 -.mk .na \fB\fBDDI_PROP_UNDEFINED\fR \fR .ad .RS 27n -.rt Prop explicitly undefined. .RE .sp .ne 2 -.mk .na \fB\fBDDI_PROP_NO_MEMORY\fR \fR .ad .RS 27n -.rt Property found, but unable to allocate memory. \fIlengthp\fR has the correct property length. .RE .sp .ne 2 -.mk .na \fB\fBDDI_PROP_BUF_TOO_SMALL\fR \fR .ad .RS 27n -.rt Property found, but the supplied buffer is too small. \fIlengthp\fR has the correct property length. .RE @@ -262,7 +230,7 @@ xxprop_op(dev_t dev, dev_info_t *dip, ddi_prop_op_t prop_op, } /* other cases... */ skip: - return (ddi_prop_op(dev, dip, prop_op, flags,\e + return (ddi_prop_op(dev, dip, prop_op, flags,\e name, valuep, lengthp)); } .fi diff --git a/usr/src/man/man9e/put.9e b/usr/src/man/man9e/put.9e index 18d23a511a..9d7c47c86f 100644 --- a/usr/src/man/man9e/put.9e +++ b/usr/src/man/man9e/put.9e @@ -4,7 +4,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH put 9E "12 Nov 1992" "SunOS 5.11" "Driver Entry Points" +.TH PUT 9E "Nov 12, 1992" .SH NAME put \- receive messages from the preceding queue .SH SYNOPSIS @@ -23,7 +23,7 @@ put \- receive messages from the preceding queue .LP .nf -\fBint prefix\fR\fBwput\fR(\fBqueue_t *\fR\fIq\fR, \fBmblk_t\fR \fI*mp\fR/* write side */ +\fBint prefix\fR\fBwput\fR(\fBqueue_t *\fR\fIq\fR, \fBmblk_t\fR \fI*mp\fR/* write side */ .fi .SH INTERFACE LEVEL @@ -34,23 +34,19 @@ Architecture independent level 1 (DDI/DKI). This entry point is required for .SH ARGUMENTS .sp .ne 2 -.mk .na \fB\fIq\fR \fR .ad .RS 7n -.rt Pointer to the \fBqueue\fR(9S) structure. .RE .sp .ne 2 -.mk .na \fB\fImp\fR \fR .ad .RS 7n -.rt Pointer to the message block. .RE diff --git a/usr/src/man/man9e/quiesce.9e b/usr/src/man/man9e/quiesce.9e index 35937f7714..f6cc33dd11 100644 --- a/usr/src/man/man9e/quiesce.9e +++ b/usr/src/man/man9e/quiesce.9e @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH quiesce 9E "16 Sep 2008" "SunOS 5.11" "Driver Entry Points" +.TH QUIESCE 9E "Sep 16, 2008" .SH NAME quiesce \- quiesce a device .SH SYNOPSIS @@ -27,12 +27,10 @@ Solaris DDI specific (Solaris DDI) .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIdip\fR\fR .ad .RS 7n -.rt A pointer to the device's \fBdev_info\fR structure. .RE @@ -86,23 +84,19 @@ indicate that the device it manages does not need to be quiesced. \fBquiesce()\fR returns the following: .sp .ne 2 -.mk .na \fB\fBDDI_SUCCESS\fR\fR .ad .RS 15n -.rt The device has been successfully quiesced. .RE .sp .ne 2 -.mk .na \fB\fBDDI_FAILURE\fR\fR .ad .RS 15n -.rt The operation failed. .RE diff --git a/usr/src/man/man9e/read.9e b/usr/src/man/man9e/read.9e index 78efdccacb..276003593e 100644 --- a/usr/src/man/man9e/read.9e +++ b/usr/src/man/man9e/read.9e @@ -1,10 +1,10 @@ '\" te -.\" Copyright 1989 AT&T +.\" Copyright 1989 AT&T .\" Copyright (c) 1997, Sun Microsystems, Inc. All Rights Reserved .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH read 9E "19 Nov 1997" "SunOS 5.11" "Driver Entry Points" +.TH READ 9E "Nov 19, 1997" .SH NAME read \- read data from a device .SH SYNOPSIS @@ -30,35 +30,29 @@ Architecture independent level 1 (DDI/DKI). This entry point is \fIoptional\fR. .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIdev\fR \fR .ad .RS 11n -.rt Device number. .RE .sp .ne 2 -.mk .na \fB\fIuio_p\fR \fR .ad .RS 11n -.rt Pointer to the \fBuio\fR(9S) structure that describes where the data is to be stored in user space. .RE .sp .ne 2 -.mk .na \fB\fIcred_p\fR \fR .ad .RS 11n -.rt Pointer to the user credential structure for the \fBI/O \fRtransaction. .RE diff --git a/usr/src/man/man9e/segmap.9e b/usr/src/man/man9e/segmap.9e index 853f0c0179..9eb7aa75f0 100644 --- a/usr/src/man/man9e/segmap.9e +++ b/usr/src/man/man9e/segmap.9e @@ -1,10 +1,10 @@ '\" te -.\" Copyright 1989 AT&T +.\" Copyright 1989 AT&T .\" Copyright (c) 1995, Sun Microsystems, Inc. All Rights Reserved .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH segmap 9E "14 Jan 1997" "SunOS 5.11" "Driver Entry Points" +.TH SEGMAP 9E "Jan 14, 1997" .SH NAME segmap \- map device memory into user space .SH SYNOPSIS @@ -31,122 +31,100 @@ Architecture independent level 2 (DKI only). .SH ARGUMENTS .sp .ne 2 -.mk .na \fB\fIdev\fR \fR .ad .RS 12n -.rt Device whose memory is to be mapped. .RE .sp .ne 2 -.mk .na \fB\fIoff\fR \fR .ad .RS 12n -.rt Offset within device memory at which mapping begins. .RE .sp .ne 2 -.mk .na \fB\fIasp\fR \fR .ad .RS 12n -.rt Pointer to the address space into which the device memory should be mapped. .RE .sp .ne 2 -.mk .na \fB\fIaddrp\fR \fR .ad .RS 12n -.rt Pointer to the address in the address space to which the device memory should be mapped. .RE .sp .ne 2 -.mk .na \fB\fIlen\fR \fR .ad .RS 12n -.rt Length (in bytes) of the memory to be mapped. .RE .sp .ne 2 -.mk .na \fB\fIprot\fR \fR .ad .RS 12n -.rt A bit field that specifies the protections. Possible settings are: .sp .ne 2 -.mk .na \fB\fBPROT_READ\fR \fR .ad .RS 15n -.rt Read access is desired. .RE .sp .ne 2 -.mk .na \fB\fBPROT_WRITE\fR \fR .ad .RS 15n -.rt Write access is desired. .RE .sp .ne 2 -.mk .na \fB\fBPROT_EXEC\fR \fR .ad .RS 15n -.rt Execute access is desired. .RE .sp .ne 2 -.mk .na \fB\fBPROT_USER\fR \fR .ad .RS 15n -.rt User-level access is desired (the mapping is being done as a result of a \fBmmap\fR(2) system call). .RE .sp .ne 2 -.mk .na \fB\fBPROT_ALL\fR \fR .ad .RS 15n -.rt All access is desired. .RE @@ -154,44 +132,36 @@ All access is desired. .sp .ne 2 -.mk .na \fB\fImaxprot\fR \fR .ad .RS 12n -.rt Maximum protection flag possible for attempted mapping; the \fBPROT_WRITE\fR bit may be masked out if the user opened the special file read-only. .RE .sp .ne 2 -.mk .na \fB\fIflags\fR \fR .ad .RS 12n -.rt Flags indicating type of mapping. Possible values are (other bits may be set): .sp .ne 2 -.mk .na \fB\fBMAP_SHARED\fR \fR .ad .RS 16n -.rt Changes should be shared. .RE .sp .ne 2 -.mk .na \fB\fBMAP_PRIVATE\fR \fR .ad .RS 16n -.rt Changes are private. .RE @@ -199,12 +169,10 @@ Changes are private. .sp .ne 2 -.mk .na \fB\fIcred_p\fR \fR .ad .RS 12n -.rt Pointer to the user credentials structure. .RE diff --git a/usr/src/man/man9e/srv.9e b/usr/src/man/man9e/srv.9e index 1002ef7060..2df363f0e9 100644 --- a/usr/src/man/man9e/srv.9e +++ b/usr/src/man/man9e/srv.9e @@ -4,7 +4,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH srv 9E "12 Nov 1992" "SunOS 5.11" "Driver Entry Points" +.TH SRV 9E "Nov 12, 1992" .SH NAME srv \- service queued messages .SH SYNOPSIS @@ -34,12 +34,10 @@ Architecture independent level 1 (DDI/DKI). This entry point is required for .SH ARGUMENTS .sp .ne 2 -.mk .na \fB\fIq\fR\fR .ad .RS 5n -.rt Pointer to the \fBqueue\fR(9S) structure. .RE diff --git a/usr/src/man/man9e/strategy.9e b/usr/src/man/man9e/strategy.9e index a41040aaca..fd8cf7fcd7 100644 --- a/usr/src/man/man9e/strategy.9e +++ b/usr/src/man/man9e/strategy.9e @@ -4,7 +4,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH strategy 9E "6 Nov 2003" "SunOS 5.11" "Driver Entry Points" +.TH STRATEGY 9E "Nov 6, 2003" .SH NAME strategy \- perform block I/O .SH SYNOPSIS @@ -28,12 +28,10 @@ block devices. .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIbp\fR \fR .ad .RS 7n -.rt Pointer to the \fBbuf\fR(9S) structure. .RE diff --git a/usr/src/man/man9e/tran_abort.9e b/usr/src/man/man9e/tran_abort.9e index 9f480b2298..5d8ddf4de4 100644 --- a/usr/src/man/man9e/tran_abort.9e +++ b/usr/src/man/man9e/tran_abort.9e @@ -3,17 +3,17 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH tran_abort 9E "17 Aug 2005" "SunOS 5.11" "Driver Entry Points" +.TH TRAN_ABORT 9E "Aug 17, 2005" .SH NAME tran_abort \- abort a SCSI command .SH SYNOPSIS .LP .nf -#include <sys/scsi/scsi.h> +#include <sys/scsi/scsi.h> -\fB int prefix\fR\fBtran_abort\fR(\fBstruct scsi_address *\fR\fIap\fR, +\fB int prefix\fR\fBtran_abort\fR(\fBstruct scsi_address *\fR\fIap\fR, \fBstruct scsi_pkt *\fR\fIpkt\fR); .fi @@ -24,23 +24,19 @@ Solaris architecture specific (Solaris DDI). .SH ARGUMENTS .sp .ne 2 -.mk .na \fB\fIap\fR \fR .ad .RS 8n -.rt Pointer to a \fBscsi_address\fR(9S) structure. .RE .sp .ne 2 -.mk .na \fB\fIpkt\fR \fR .ad .RS 8n -.rt Pointer to a \fBscsi_pkt\fR(9S) structure. .RE @@ -75,23 +71,19 @@ For each packet successfully aborted, \fBtran_abort()\fR must set the \fBtran_abort()\fR must return: .sp .ne 2 -.mk .na \fB\fB1\fR \fR .ad .RS 6n -.rt upon success or partial success. .RE .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 6n -.rt upon failure. .RE diff --git a/usr/src/man/man9e/tran_bus_reset.9e b/usr/src/man/man9e/tran_bus_reset.9e index 923baab297..34698a2515 100644 --- a/usr/src/man/man9e/tran_bus_reset.9e +++ b/usr/src/man/man9e/tran_bus_reset.9e @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH tran_bus_reset 9E "17 Mar 1999" "SunOS 5.11" "Driver Entry Points" +.TH TRAN_BUS_RESET 9E "Mar 17, 1999" .SH NAME tran_bus_reset \- reset a SCSI bus .SH SYNOPSIS @@ -21,23 +21,19 @@ Solaris DDI .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIhba_dip\fR\fR .ad .RS 11n -.rt The \fBdev_info_t\fR pointer associated with the SCSI HBA. .RE .sp .ne 2 -.mk .na \fB\fIlevel\fR\fR .ad .RS 11n -.rt The level of reset required. .RE @@ -56,12 +52,10 @@ control interfaces. \fIlevel\fR will be one of the following: .sp .ne 2 -.mk .na \fB\fBRESET_BUS\fR\fR .ad .RS 13n -.rt Reset the SCSI bus only, not the targets. .RE @@ -76,23 +70,19 @@ driver should not initialize this vector or return failure. \fBtran_bus_reset()\fR should return: .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 5n -.rt on success. .RE .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 5n -.rt on failure. .RE @@ -104,13 +94,12 @@ See \fBattributes\fR(5) for a description of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man9e/tran_dmafree.9e b/usr/src/man/man9e/tran_dmafree.9e index 8e6f1995ce..c9c2408710 100644 --- a/usr/src/man/man9e/tran_dmafree.9e +++ b/usr/src/man/man9e/tran_dmafree.9e @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH tran_dmafree 9E "30 Aug 1995" "SunOS 5.11" "Driver Entry Points" +.TH TRAN_DMAFREE 9E "Aug 30, 1995" .SH NAME tran_dmafree \- SCSI HBA DMA deallocation entry point .SH SYNOPSIS @@ -23,23 +23,19 @@ Solaris architecture specific (Solaris DDI). .SH ARGUMENTS .sp .ne 2 -.mk .na \fB\fIap\fR\fR .ad .RS 8n -.rt A pointer to a \fIscsi_address\fR structure. See \fBscsi_address\fR(9S). .RE .sp .ne 2 -.mk .na \fB\fIpkt\fR \fR .ad .RS 8n -.rt A pointer to a \fIscsi_pkt\fR structure. See \fBscsi_pkt\fR(9S). .RE diff --git a/usr/src/man/man9e/tran_getcap.9e b/usr/src/man/man9e/tran_getcap.9e index c4556b02d4..cc70777dfe 100644 --- a/usr/src/man/man9e/tran_getcap.9e +++ b/usr/src/man/man9e/tran_getcap.9e @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH tran_getcap 9E "30 Aug 1995" "SunOS 5.11" "Driver Entry Points" +.TH TRAN_GETCAP 9E "Aug 30, 1995" .SH NAME tran_getcap, tran_setcap \- get/set SCSI transport capability .SH SYNOPSIS .LP .nf -#include <sys/scsi/scsi.h> +#include <sys/scsi/scsi.h> @@ -29,45 +29,37 @@ Solaris architecture specific (Solaris DDI). .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIap\fR \fR .ad .RS 10n -.rt Pointer to the \fBscsi_address\fR(9S) structure. .RE .sp .ne 2 -.mk .na \fB\fIcap\fR \fR .ad .RS 10n -.rt Pointer to the string capability identifier. .RE .sp .ne 2 -.mk .na \fB\fIvalue\fR \fR .ad .RS 10n -.rt Defines the new state of the capability. .RE .sp .ne 2 -.mk .na \fB\fIwhom\fR \fR .ad .RS 10n -.rt Specifies whether all targets or only the specified target is affected. .RE diff --git a/usr/src/man/man9e/tran_init_pkt.9e b/usr/src/man/man9e/tran_init_pkt.9e index 967e434637..781422e5b3 100644 --- a/usr/src/man/man9e/tran_init_pkt.9e +++ b/usr/src/man/man9e/tran_init_pkt.9e @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH tran_init_pkt 9E "11 Jan 2009" "SunOS 5.11" "Driver Entry Points" +.TH TRAN_INIT_PKT 9E "Jan 11, 2009" .SH NAME tran_init_pkt, tran_destroy_pkt \- SCSI HBA packet preparation and deallocation .SH SYNOPSIS @@ -12,7 +12,7 @@ tran_init_pkt, tran_destroy_pkt \- SCSI HBA packet preparation and deallocation #include <sys/scsi/scsi.h> \fBstruct scsi_pkt *prefix\fR\fBtran_init_pkt\fR(\fBstruct scsi_address *\fR\fIap\fR, - \fBstruct scsi_pkt *\fR\fIpkt\fR, \fBstruct buf *\fR\fIbp\fR, \fBint\fR \fIcmdlen\fR, + \fBstruct scsi_pkt *\fR\fIpkt\fR, \fBstruct buf *\fR\fIbp\fR, \fBint\fR \fIcmdlen\fR, \fBint\fR \fIstatuslen\fR, \fBint\fR \fItgtlen\fR, \fBint\fR\fIflags\fR, \fBint (*\fR\fIcallback\fR, \fBcaddr_t),caddr_t\fR \fIarg\fR); .fi @@ -30,105 +30,87 @@ Solaris architecture specific (Solaris DDI). .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIap\fR\fR .ad .RS 13n -.rt Pointer to a \fBscsi_address\fR(9S) structure. .RE .sp .ne 2 -.mk .na \fB\fIpkt\fR\fR .ad .RS 13n -.rt Pointer to a \fBscsi_pkt\fR(9S) structure allocated in an earlier call, or \fINULL\fR. .RE .sp .ne 2 -.mk .na \fB\fIbp\fR\fR .ad .RS 13n -.rt Pointer to a \fBbuf\fR(9S) structure if \fBDMA \fRresources are to be allocated for the \fIpkt\fR, or \fINULL\fR. .RE .sp .ne 2 -.mk .na \fB\fIcmdlen\fR\fR .ad .RS 13n -.rt The required length for the \fBSCSI \fRcommand descriptor block (\fBCDB\fR) in bytes. .RE .sp .ne 2 -.mk .na \fB\fIstatuslen\fR\fR .ad .RS 13n -.rt The required length for the \fBSCSI \fRstatus completion block (\fBSCB\fR) in bytes. .RE .sp .ne 2 -.mk .na \fB\fItgtlen\fR\fR .ad .RS 13n -.rt The length of the packet private area within the \fBscsi_pkt\fR to be allocated on behalf of the \fBSCSI \fRtarget driver. .RE .sp .ne 2 -.mk .na \fB\fIflags\fR\fR .ad .RS 13n -.rt Flags for creating the packet. .RE .sp .ne 2 -.mk .na \fB\fIcallback\fR\fR .ad .RS 13n -.rt Pointer to either \fBNULL_FUNC\fR or \fBSLEEP_FUNC\fR. .RE .sp .ne 2 -.mk .na \fB\fIarg\fR\fR .ad .RS 13n -.rt Always \fINULL\fR. .RE @@ -217,23 +199,19 @@ Note: \fItgtlen\fR, \fIstatuslen\fR, and \fIcmdlen\fR are used only when the are not available: .sp .ne 2 -.mk .na \fB\fBNULL_FUNC\fR\fR .ad .RS 14n -.rt Do not wait for resources. Return a \fINULL\fR pointer. .RE .sp .ne 2 -.mk .na \fB\fBSLEEP_FUNC\fR\fR .ad .RS 14n -.rt Wait indefinitely for resources. .RE diff --git a/usr/src/man/man9e/tran_quiesce.9e b/usr/src/man/man9e/tran_quiesce.9e index 1d6b2eba8f..cf5c96cc93 100644 --- a/usr/src/man/man9e/tran_quiesce.9e +++ b/usr/src/man/man9e/tran_quiesce.9e @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH tran_quiesce 9E "31 Jan 1999" "SunOS 5.11" "Driver Entry Points" +.TH TRAN_QUIESCE 9E "Jan 31, 1999" .SH NAME tran_quiesce, tran_unquiesce \- quiesce and unquiesce a SCSI bus .SH SYNOPSIS @@ -26,12 +26,10 @@ Solaris DDI .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIhba_dip\fR\fR .ad .RS 11n -.rt The \fBdev_info_t\fR pointer associated with the SCSI HBA. .RE @@ -56,23 +54,19 @@ Implementation is hardware specific. \fBtran_quiesce()\fR and \fBtran_unquiesce()\fR should return: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 12n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBNon-zero\fR\fR .ad .RS 12n -.rt An error occurred. .RE @@ -84,13 +78,12 @@ See \fBattributes\fR(5) for a description of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man9e/tran_reset.9e b/usr/src/man/man9e/tran_reset.9e index c43d61067f..8091eef104 100644 --- a/usr/src/man/man9e/tran_reset.9e +++ b/usr/src/man/man9e/tran_reset.9e @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH tran_reset 9E "17 Aug 2005" "SunOS 5.11" "Driver Entry Points" +.TH TRAN_RESET 9E "Aug 17, 2005" .SH NAME tran_reset \- reset a SCSI bus or target .SH SYNOPSIS @@ -23,23 +23,19 @@ Solaris architecture specific (Solaris DDI). .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIap\fR \fR .ad .RS 10n -.rt Pointer to the \fBscsi_address\fR(9S) structure. .RE .sp .ne 2 -.mk .na \fB\fIlevel\fR \fR .ad .RS 10n -.rt The level of reset required. .RE @@ -59,34 +55,28 @@ device, or a \fBSCSI\fR logical unit as specified by \fIlevel\fR. \fIlevel\fR must be one of the following: .sp .ne 2 -.mk .na \fB\fBRESET_ALL\fR \fR .ad .RS 17n -.rt Reset the \fBSCSI\fR bus. .RE .sp .ne 2 -.mk .na \fB\fBRESET_TARGET\fR \fR .ad .RS 17n -.rt Reset the target specified by \fIap\fR. .RE .sp .ne 2 -.mk .na \fB\fBRESET_LUN\fR \fR .ad .RS 17n -.rt Reset the logical unit specified by \fIap\fR. .RE @@ -122,23 +112,19 @@ of the \fBlun_reset\fR capability in its \fBtran_getcap\fR(9E) routine. \fBtran_reset()\fR should return: .sp .ne 2 -.mk .na \fB\fB1\fR \fR .ad .RS 6n -.rt on success. .RE .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 6n -.rt on failure. .RE diff --git a/usr/src/man/man9e/tran_reset_notify.9e b/usr/src/man/man9e/tran_reset_notify.9e index 9f10d933b6..f61d593769 100644 --- a/usr/src/man/man9e/tran_reset_notify.9e +++ b/usr/src/man/man9e/tran_reset_notify.9e @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH tran_reset_notify 9E "30 Aug 1995" "SunOS 5.11" "Driver Entry Points" +.TH TRAN_RESET_NOTIFY 9E "Aug 30, 1995" .SH NAME tran_reset_notify \- request to notify SCSI target of bus reset .SH SYNOPSIS @@ -13,7 +13,7 @@ tran_reset_notify \- request to notify SCSI target of bus reset -\fBint prefix\fR\fBtran_reset_notify\fR(\fBstruct scsi_address *\fR\fIap\fR, \fBint\fR \fIflag\fR, +\fBint prefix\fR\fBtran_reset_notify\fR(\fBstruct scsi_address *\fR\fIap\fR, \fBint\fR \fIflag\fR, \fBvoid (*\fR\fIcallback\fR, \fBcaddr_t),caddr_t\fR \fIarg\fR); .fi @@ -24,45 +24,37 @@ Solaris architecture specific (Solaris DDI). .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIap\fR \fR .ad .RS 13n -.rt Pointer to the \fBscsi_address\fR(9S) structure. .RE .sp .ne 2 -.mk .na \fB\fIflag\fR \fR .ad .RS 13n -.rt A flag indicating registration or cancellation of a notification request. .RE .sp .ne 2 -.mk .na \fB\fIcallback\fR \fR .ad .RS 13n -.rt A pointer to the target driver's reset notification function. .RE .sp .ne 2 -.mk .na \fB\fIarg\fR \fR .ad .RS 13n -.rt The callback function argument. .RE @@ -83,23 +75,19 @@ The argument \fIflag\fR is used to register or cancel the notification. The supported values for \fIflag\fR are as follows: .sp .ne 2 -.mk .na \fB\fBSCSI_RESET_NOTIFY\fR \fR .ad .RS 22n -.rt Register \fIcallback\fR as the reset notification function for the target. .RE .sp .ne 2 -.mk .na \fB\fBSCSI_RESET_CANCEL\fR \fR .ad .RS 22n -.rt Cancel the reset notification request for the target. .RE diff --git a/usr/src/man/man9e/tran_setup_pkt.9e b/usr/src/man/man9e/tran_setup_pkt.9e index bf3d9c4c14..c839c1624c 100644 --- a/usr/src/man/man9e/tran_setup_pkt.9e +++ b/usr/src/man/man9e/tran_setup_pkt.9e @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH tran_setup_pkt 9E "29 Jan 2009" "SunOS 5.11" "Driver Entry Points" +.TH TRAN_SETUP_PKT 9E "Jan 29, 2009" .SH NAME tran_setup_pkt, tran_teardown_pkt, tran_pkt_constructor, tran_pkt_destructor \- SCSI HBA packet allocation and deallocation @@ -40,56 +40,46 @@ Solaris architecture specific (Solaris DDI). .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIpkt\fR\fR .ad .RS 12n -.rt Pointer to the \fBscsi_pkt\fR(9S) structure. .RE .sp .ne 2 -.mk .na \fB\fIflags\fR\fR .ad .RS 12n -.rt Flags for associating DMA resources with the packet. .RE .sp .ne 2 -.mk .na \fB\fIcallback\fR\fR .ad .RS 12n -.rt Pointer to either \fBNULL_FUNC\fR or \fBSLEEP_FUNC\fR. .RE .sp .ne 2 -.mk .na \fB\fIarg\fR\fR .ad .RS 12n -.rt Always \fINULL\fR. .RE .sp .ne 2 -.mk .na \fB\fIkmflags\fR\fR .ad .RS 12n -.rt Either \fBKM_SLEEP\fR or \fBKM_NOSLEEP\fR. .RE @@ -144,23 +134,19 @@ The \fIcallback\fR argument indicates what the allocator routines should do when resources are not available: .sp .ne 2 -.mk .na \fB\fBNULL_FUNC\fR\fR .ad .RS 14n -.rt Do not wait for resources. Return a \fINULL\fR pointer. .RE .sp .ne 2 -.mk .na \fB\fBSLEEP_FUNC\fR\fR .ad .RS 14n -.rt Wait indefinitely for resources. .RE diff --git a/usr/src/man/man9e/tran_start.9e b/usr/src/man/man9e/tran_start.9e index 2de673eded..5b3059e4f9 100644 --- a/usr/src/man/man9e/tran_start.9e +++ b/usr/src/man/man9e/tran_start.9e @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH tran_start 9E "17 Aug 2005" "SunOS 5.11" "Driver Entry Points" +.TH TRAN_START 9E "Aug 17, 2005" .SH NAME tran_start \- request to transport a SCSI command .SH SYNOPSIS @@ -24,23 +24,19 @@ Solaris architecture specific (Solaris DDI). .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIpkt\fR \fR .ad .RS 8n -.rt Pointer to the \fBscsi_pkt\fR(9S) structure that is about to be transferred. .RE .sp .ne 2 -.mk .na \fB\fIap\fR \fR .ad .RS 8n -.rt Pointer to a \fBscsi_address\fR(9S) structure. .RE @@ -149,24 +145,20 @@ values in these members are updated to accurately reflect the states through which the command transitioned while in the transport layer. .sp .ne 2 -.mk .na \fB\fBpkt_resid\fR \fR .ad .RS 19n -.rt For commands with data transfer, this member must be updated to indicate the residual of the data transferred. .RE .sp .ne 2 -.mk .na \fB\fBpkt_reason\fR\fR .ad .RS 19n -.rt The reason for the command completion. This field should be set to \fBCMD_CMPLT\fR at the beginning of \fBtran_start()\fR, then updated if the command ever transitions to an abnormal termination state. To avoid losing @@ -176,23 +168,19 @@ still has its original \fBCMD_CMPLT\fR value. .sp .ne 2 -.mk .na \fB\fBpkt_statistics\fR \fR .ad .RS 19n -.rt Bit field of transport-related statistics. .RE .sp .ne 2 -.mk .na \fB\fBpkt_state\fR \fR .ad .RS 19n -.rt Bit field with the major states through which a \fBSCSI\fR command can transition. Note: The members listed above, and \fBpkt_hba_private\fR member, are the only fields in the \fBscsi_pkt\fR(9S) structure which may be modified @@ -205,23 +193,19 @@ by the transport layer. \fBtran_start()\fR must return: .sp .ne 2 -.mk .na \fB\fBTRAN_ACCEPT\fR \fR .ad .RS 21n -.rt The packet was accepted by the transport layer. .RE .sp .ne 2 -.mk .na \fB\fBTRAN_BUSY\fR \fR .ad .RS 21n -.rt The packet could not be accepted because there was already a packet in progress for this target/logical unit, the \fBHBA \fRqueue was full, or the target device queue was full. @@ -229,24 +213,20 @@ device queue was full. .sp .ne 2 -.mk .na \fB\fBTRAN_BADPKT\fR \fR .ad .RS 21n -.rt The \fBDMA \fRcount in the packet exceeded the \fBDMA \fRengine's maximum \fBDMA \fRsize, or the packet could not be accepted for other reasons. .RE .sp .ne 2 -.mk .na \fB\fBTRAN_FATAL_ERROR\fR \fR .ad .RS 21n -.rt A fatal error has occurred in the \fBHBA. \fR .RE diff --git a/usr/src/man/man9e/tran_sync_pkt.9e b/usr/src/man/man9e/tran_sync_pkt.9e index e0c3601e6e..a1298cb0ee 100644 --- a/usr/src/man/man9e/tran_sync_pkt.9e +++ b/usr/src/man/man9e/tran_sync_pkt.9e @@ -3,17 +3,17 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH tran_sync_pkt 9E "1 Nov 1993" "SunOS 5.11" "Driver Entry Points" +.TH TRAN_SYNC_PKT 9E "Nov 1, 1993" .SH NAME tran_sync_pkt \- SCSI HBA memory synchronization entry point .SH SYNOPSIS .LP .nf -#include <sys/scsi/scsi.h> +#include <sys/scsi/scsi.h> -\fBvoid prefix\fR\fBtran_sync_pkt\fR(\fBstruct scsi_address *\fR\fIap\fR, +\fBvoid prefix\fR\fBtran_sync_pkt\fR(\fBstruct scsi_address *\fR\fIap\fR, \fBstruct scsi_pkt *\fR\fIpkt\fR); .fi @@ -24,23 +24,19 @@ Solaris architecture specific (Solaris DDI). .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIap\fR \fR .ad .RS 8n -.rt A pointer to a \fBscsi_address\fR(9S) structure. .RE .sp .ne 2 -.mk .na \fB\fIpkt\fR \fR .ad .RS 8n -.rt A pointer to a \fBscsi_pkt\fR(9S) structure. .RE diff --git a/usr/src/man/man9e/tran_tgt_free.9e b/usr/src/man/man9e/tran_tgt_free.9e index 42c6f500bc..d4262beb31 100644 --- a/usr/src/man/man9e/tran_tgt_free.9e +++ b/usr/src/man/man9e/tran_tgt_free.9e @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH tran_tgt_free 9E "1 Nov 1993" "SunOS 5.11" "Driver Entry Points" +.TH TRAN_TGT_FREE 9E "Nov 1, 1993" .SH NAME tran_tgt_free \- request to free HBA resources allocated on behalf of a target .SH SYNOPSIS @@ -24,48 +24,40 @@ Solaris architecture specific (Solaris DDI). .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIhba_dip\fR \fR .ad .RS 13n -.rt Pointer to a \fBdev_info_t\fR structure, referring to the \fBHBA\fR device instance. .RE .sp .ne 2 -.mk .na \fB\fItgt_dip\fR \fR .ad .RS 13n -.rt Pointer to a \fBdev_info_t\fR structure, referring to the target device instance. .RE .sp .ne 2 -.mk .na \fB\fIhba_tran\fR \fR .ad .RS 13n -.rt Pointer to a \fBscsi_hba_tran\fR(9S) structure, consisting of the \fBHBA\fR's transport vectors. .RE .sp .ne 2 -.mk .na \fB\fIsd\fR \fR .ad .RS 13n -.rt Pointer to a \fBscsi_device\fR(9S) structure, describing the target. .RE diff --git a/usr/src/man/man9e/tran_tgt_init.9e b/usr/src/man/man9e/tran_tgt_init.9e index d6be9313dd..0100cd0f3e 100644 --- a/usr/src/man/man9e/tran_tgt_init.9e +++ b/usr/src/man/man9e/tran_tgt_init.9e @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH tran_tgt_init 9E "1 Nov 1993" "SunOS 5.11" "Driver Entry Points" +.TH TRAN_TGT_INIT 9E "Nov 1, 1993" .SH NAME tran_tgt_init \- request to initialize HBA resources on behalf of a particular target @@ -25,48 +25,40 @@ Solaris architecture specific (Solaris DDI). .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIhba_dip\fR \fR .ad .RS 13n -.rt Pointer to a \fBdev_info_t\fR structure, referring to the \fBHBA\fR device instance. .RE .sp .ne 2 -.mk .na \fB\fItgt_dip\fR \fR .ad .RS 13n -.rt Pointer to a \fBdev_info_t\fR structure, referring to the target device instance. .RE .sp .ne 2 -.mk .na \fB\fIhba_tran\fR \fR .ad .RS 13n -.rt Pointer to a \fBscsi_hba_tran\fR(9S) structure, consisting of the \fBHBA\fR's transport vectors. .RE .sp .ne 2 -.mk .na \fB\fIsd\fR \fR .ad .RS 13n -.rt Pointer to a \fBscsi_device\fR(9S) structure, describing the target. .RE @@ -97,24 +89,20 @@ instance. \fBtran_tgt_init()\fR must return: .sp .ne 2 -.mk .na \fB\fBDDI_SUCCESS\fR \fR .ad .RS 16n -.rt the \fBHBA\fR driver can support the addressed target, and was able to initialize per-target resources. .RE .sp .ne 2 -.mk .na \fB\fBDDI_FAILURE\fR \fR .ad .RS 16n -.rt the \fBHBA\fR driver cannot support the addressed target, or was unable to initialize per-target resources. In this event, the initialization of this instance of the target device will not be continued, the target driver's diff --git a/usr/src/man/man9e/tran_tgt_probe.9e b/usr/src/man/man9e/tran_tgt_probe.9e index 5271c7d36a..1b66da0737 100644 --- a/usr/src/man/man9e/tran_tgt_probe.9e +++ b/usr/src/man/man9e/tran_tgt_probe.9e @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH tran_tgt_probe 9E "1 Nov 1993" "SunOS 5.11" "Driver Entry Points" +.TH TRAN_TGT_PROBE 9E "Nov 1, 1993" .SH NAME tran_tgt_probe \- request to probe SCSI bus for a particular target .SH SYNOPSIS .LP .nf -#include <sys/scsi/scsi.h> +#include <sys/scsi/scsi.h> @@ -24,23 +24,19 @@ Solaris architecture specific (Solaris DDI). .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIsd\fR \fR .ad .RS 13n -.rt Pointer to a \fBscsi_device\fR(9S) structure. .RE .sp .ne 2 -.mk .na \fB\fIwaitfunc\fR \fR .ad .RS 13n -.rt Pointer to either \fBNULL_FUNC\fR or \fBSLEEP_FUNC\fR. .RE @@ -79,24 +75,20 @@ are preserved. are not available: .sp .ne 2 -.mk .na \fB\fBNULL_FUNC\fR \fR .ad .RS 15n -.rt Do not wait for resources. See \fBscsi_probe\fR(9F) for defined return values if no resources are available. .RE .sp .ne 2 -.mk .na \fB\fBSLEEP_FUNC\fR \fR .ad .RS 15n -.rt Wait indefinitely for resources. .RE diff --git a/usr/src/man/man9e/write.9e b/usr/src/man/man9e/write.9e index 2f918bae69..4e41effc03 100644 --- a/usr/src/man/man9e/write.9e +++ b/usr/src/man/man9e/write.9e @@ -5,7 +5,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (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] -.TH write 9E "28 Mar 1997" "SunOS 5.11" "Driver Entry Points" +.TH WRITE 9E "Mar 28, 1997" .SH NAME write \- write data to a device .SH SYNOPSIS @@ -30,35 +30,29 @@ Architecture independent level 1 (DDI/DKI). This entry point is optional. .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIdev\fR \fR .ad .RS 11n -.rt Device number. .RE .sp .ne 2 -.mk .na \fB\fIuio_p\fR \fR .ad .RS 11n -.rt Pointer to the \fBuio\fR(9S) structure that describes where the data is to be stored in user space. .RE .sp .ne 2 -.mk .na \fB\fIcred_p\fR \fR .ad .RS 11n -.rt Pointer to the user credential structure for the \fBI/O \fRtransaction. .RE |