diff options
Diffstat (limited to 'usr/src/man/man9f')
| -rw-r--r-- | usr/src/man/man9f/Makefile | 20 | ||||
| -rw-r--r-- | usr/src/man/man9f/bioerror.9f | 9 | ||||
| -rw-r--r-- | usr/src/man/man9f/canputnext.9f | 4 | ||||
| -rw-r--r-- | usr/src/man/man9f/csx_RegisterClient.9f | 11 | ||||
| -rw-r--r-- | usr/src/man/man9f/dlbindack.9f | 13 | ||||
| -rw-r--r-- | usr/src/man/man9f/id_space.9f | 266 | ||||
| -rw-r--r-- | usr/src/man/man9f/ldi_add_event_handler.9f | 11 | ||||
| -rw-r--r-- | usr/src/man/man9f/ldi_remove_event_handler.9f | 10 | ||||
| -rw-r--r-- | usr/src/man/man9f/scsi_ifgetcap.9f | 11 | ||||
| -rw-r--r-- | usr/src/man/man9f/scsi_validate_sense.9f | 10 | ||||
| -rw-r--r-- | usr/src/man/man9f/scsi_vu_errmsg.9f | 11 |
11 files changed, 306 insertions, 70 deletions
diff --git a/usr/src/man/man9f/Makefile b/usr/src/man/man9f/Makefile index 066f5373f6..9e5f5f2b52 100644 --- a/usr/src/man/man9f/Makefile +++ b/usr/src/man/man9f/Makefile @@ -279,6 +279,7 @@ MANFILES= ASSERT.9f \ gld.9f \ hook_alloc.9f \ hook_free.9f \ + id_space.9f \ id32_alloc.9f \ inb.9f \ insq.9f \ @@ -893,6 +894,15 @@ MANLINKS= SIZEOF_PTR.9f \ gld_register.9f \ gld_sched.9f \ gld_unregister.9f \ + id_space_create.9f \ + id_space_destroy.9f \ + id_space_extend.9f \ + id_alloc.9f \ + id_alloc_nosleep.9f \ + id_allocff.9f \ + id_allocff_nosleep.9f \ + id_alloc_specific_nosleep.9f \ + id_free.9f \ id32_free.9f \ id32_lookup.9f \ inl.9f \ @@ -1660,6 +1670,16 @@ gld_register.9f := LINKSRC = gld.9f gld_sched.9f := LINKSRC = gld.9f gld_unregister.9f := LINKSRC = gld.9f +id_space_create.9f := LINKSRC = id_space.9f +id_space_destroy.9f := LINKSRC = id_space.9f +id_space_extend.9f := LINKSRC = id_space.9f +id_alloc.9f := LINKSRC = id_space.9f +id_alloc_nosleep.9f := LINKSRC = id_space.9f +id_allocff.9f := LINKSRC = id_space.9f +id_allocff_nosleep.9f := LINKSRC = id_space.9f +id_alloc_specific_nosleep.9f := LINKSRC = id_space.9f +id_free.9f := LINKSRC = id_space.9f + id32_free.9f := LINKSRC = id32_alloc.9f id32_lookup.9f := LINKSRC = id32_alloc.9f diff --git a/usr/src/man/man9f/bioerror.9f b/usr/src/man/man9f/bioerror.9f index c242956dd5..e20dafb834 100644 --- a/usr/src/man/man9f/bioerror.9f +++ b/usr/src/man/man9f/bioerror.9f @@ -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 BIOERROR 9F "May 26, 1994" +.TH BIOERROR 9F "April 9, 2016" .SH NAME bioerror \- indicate error in buffer header .SH SYNOPSIS @@ -19,11 +19,9 @@ bioerror \- indicate error in buffer header .fi .SH INTERFACE LEVEL -.sp .LP Solaris DDI specific (Solaris DDI) .SH PARAMETERS -.sp .ne 2 .na \fB\fIbp\fR \fR @@ -42,9 +40,8 @@ Error number to be set, or zero to clear an error indication. .RE .SH DESCRIPTION -.sp .LP -If \fIerror\fR is non-zero, \fBbioerror()\fR indicates an error has occured in +If \fIerror\fR is non-zero, \fBbioerror()\fR indicates an error has occurred in the \fBbuf\fR(9S) structure. A subsequent call to \fBgeterror\fR(9F) will return \fIerror\fR. .sp @@ -52,10 +49,8 @@ return \fIerror\fR. If \fIerror\fR is \fB0\fR, the error indication is cleared and a subsequent call to \fBgeterror\fR(9F) will return \fB0\fR. .SH CONTEXT -.sp .LP \fBbioerror()\fR can be called from any context. .SH SEE ALSO -.sp .LP \fBstrategy\fR(9E), \fBgeterror\fR(9F), \fBgetrbuf\fR(9F), \fBbuf\fR(9S) diff --git a/usr/src/man/man9f/canputnext.9f b/usr/src/man/man9f/canputnext.9f index cb53fe3a58..f2675dbd05 100644 --- a/usr/src/man/man9f/canputnext.9f +++ b/usr/src/man/man9f/canputnext.9f @@ -11,7 +11,7 @@ .\" .\" Copyright 2014 Garrett D'Amore <garrett@damore.org> .\" -.Dd "Dec 15, 2014" +.Dd "April 9, 2016" .Dt CANPUTNEXT 9F .Os .Sh NAME @@ -43,7 +43,7 @@ They are preferable to and safer than calling .Xr canput 9F and .Xr bcanput 9F -directly on the the queue linked to by +directly on the queue linked to by .Fa q Ns No -> Ns Fa q_next . .Lp Drivers and modules should call these routines to ensure that room diff --git a/usr/src/man/man9f/csx_RegisterClient.9f b/usr/src/man/man9f/csx_RegisterClient.9f index 66bf3b8136..fe807b8a08 100644 --- a/usr/src/man/man9f/csx_RegisterClient.9f +++ b/usr/src/man/man9f/csx_RegisterClient.9f @@ -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 CSX_REGISTERCLIENT 9F "Jul 19, 1996" +.TH CSX_REGISTERCLIENT 9F "April 9, 2016" .SH NAME csx_RegisterClient \- register a client .SH SYNOPSIS @@ -17,11 +17,9 @@ csx_RegisterClient \- register a client .fi .SH INTERFACE LEVEL -.sp .LP Solaris \fBDDI\fR Specific (Solaris \fBDDI\fR) .SH PARAMETERS -.sp .ne 2 .na \fB\fIch\fR\fR @@ -40,13 +38,11 @@ Pointer to a \fBclient_reg_t\fR structure. .RE .SH DESCRIPTION -.sp .LP This function registers a client with Card Services and returns a unique client handle for the client. The client handle must be passed to \fBcsx_DeregisterClient\fR(9F) when the client terminates. .SH STRUCTURE MEMBERS -.sp .LP The structure members of \fBclient_reg_t\fR are: .sp @@ -156,7 +152,7 @@ of the bits must be set. .RS 4n If either of these bits is set, the client will receive a \fBCS_EVENT_REGISTRATION_COMPLETE\fR event when Card Services has completed its -internal client registration processing and after a sucessful call to +internal client registration processing and after a successful call to \fBcsx_RequestSocketMask\fR(9F). .sp Also, if either of these bits is set, and if a card of the type that the client @@ -255,7 +251,6 @@ identical across all instances of the driver. .RE .SH RETURN VALUES -.sp .ne 2 .na \fB\fBCS_SUCCESS\fR\fR @@ -310,11 +305,9 @@ No \fBPCMCIA\fR hardware installed. .RE .SH CONTEXT -.sp .LP This function may be called from user or kernel context. .SH SEE ALSO -.sp .LP \fBcsx_DeregisterClient\fR(9F), \fBcsx_RequestSocketMask\fR(9F) .sp diff --git a/usr/src/man/man9f/dlbindack.9f b/usr/src/man/man9f/dlbindack.9f index b16018c6f5..d1121b47d9 100644 --- a/usr/src/man/man9f/dlbindack.9f +++ b/usr/src/man/man9f/dlbindack.9f @@ -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 DLBINDACK 9F "Jan 16, 2006" +.TH DLBINDACK 9F "April 9, 2016" .SH NAME dlbindack, dlphysaddrack, dlokack, dlerrorack, dluderrorind \- DLPI device driver helper functions @@ -42,11 +42,9 @@ driver helper functions .fi .SH INTERFACE LEVEL -.sp .LP Solaris DDI specific (Solaris DDI). .SH PARAMETERS -.sp .ne 2 .na \fB\fIwq\fR\fR @@ -148,7 +146,6 @@ in the \fBDLPI\fR request. .RE .SH DESCRIPTION -.sp .LP All functions described in this manpage take a pointer to the message passed to the \fBDLPI\fR provider (\fBmblk_t\fR) and attempt to reuse it in formulating @@ -160,12 +157,12 @@ All functions reply upstream using \fBqreply\fR(9F). The write-side queue pointer must be provided. .sp .LP -The \fBdlokack()\fR function provides the successfull acknowledgement +The \fBdlokack()\fR function provides the successful acknowledgement \fBDL_OK_ACK\fR message reply to the \fBDLPI\fR provider and is used to complete many of the \fBDLPI\fR requests in the \fBDLPI\fR consumer. .sp .LP -The \fBdlerrorack()\fR function provides the unsuccessfull acknowledgement +The \fBdlerrorack()\fR function provides the unsuccessful acknowledgement \fBDL_ERROR_ACK\fR message reply to the \fBDLPI\fR() provider and is used for error completions were required for \fBDLPI\fR requests in the \fBDLPI\fR consumer. @@ -183,21 +180,17 @@ message reply used to complete the \fBDL_PHYS_ADDR_ACK\fR processing. The \fBdluderrorind()\fR function provides the \fBDL_UDERROR_IND\fR message reply used to complete an unsuccessful \fBDL_UNITDATA_REQ\fR. .SH RETURN VALUES -.sp .LP None. .SH NOTES -.sp .LP These functions are not required if you are are writing a \fBDLPI\fR device driver using \fBgld\fR(7D). .SH CONTEXT -.sp .LP All \fBDLPI\fR helper functions can be called from user, interrupt, or kernel context. .SH SEE ALSO -.sp .LP \fBgld\fR(7D), \fBdlpi\fR(7P), \fBqreply\fR(9F) .sp diff --git a/usr/src/man/man9f/id_space.9f b/usr/src/man/man9f/id_space.9f new file mode 100644 index 0000000000..b9770cab1f --- /dev/null +++ b/usr/src/man/man9f/id_space.9f @@ -0,0 +1,266 @@ +.\" +.\" This file and its contents are supplied under the terms of the +.\" Common Development and Distribution License ("CDDL"), version 1.0. +.\" You may only use this file in accordance with the terms of version +.\" 1.0 of the CDDL. +.\" +.\" A full copy of the text of the CDDL should have accompanied this +.\" source. A copy of the CDDL is also available via the Internet at +.\" http://www.illumos.org/license/CDDL. +.\" +.\" +.\" Copyright 2016 Joyent, Inc. +.\" +.Dd June 04, 2016 +.Dt ID_SPACE 9F +.Os +.Sh NAME +.Nm id_space , +.Nm id_space_create , +.Nm id_space_destroy , +.Nm id_space_extend , +.Nm id_alloc , +.Nm id_alloc_nosleep , +.Nm id_allocff , +.Nm id_allocff_nosleep , +.Nm id_alloc_specific_nosleep , +.Nm id_free +.Nd create, destroy, and use identifier spaces +.Sh SYNOPSIS +.In sys/id_space.h +.Ft "id_space_t *" +.Fo id_space_create +.Fa "const char *name" +.Fa "id_t low" +.Fa "id_t high" +.Fc +.Ft void +.Fo id_space_destroy +.Fa "id_space_t *idspace" +.Fc +.Ft void +.Fo id_space_extend +.Fa "id_t low" +.Fa "id_t high" +.Fc +.Ft id_t +.Fo id_alloc +.Fa "id_space_t *idspace" +.Fc +.Ft id_t +.Fo id_alloc_nosleep +.Fa "id_space_t *idspace" +.Fc +.Ft id_t +.Fo id_allocff +.Fa "id_space_t *idspace" +.Fc +.Ft id_t +.Fo id_allocff_nosleep +.Fa "id_space_t *idspace" +.Fc +.Ft id_t +.Fo id_allocff_specific_nosleep +.Fa "id_space_t *idspace" +.Fa "id_t id" +.Fc +.Ft void +.Fo id_free +.Fa "id_space_t *idspace" +.Fa "id_t id" +.Fc +.Sh INTERFACE STABILITY +illumos DDI specific +.Sh PARAMETERS +.Bl -tag -width Fa +.It Fa idspace +A pointer to an +.Sy id_space_t +structure allocated with the +.Fn id_space_create +function. +.It Fa id +An identifier, a signed 32-bit integer. +.It Fa name +A null-terminated ASCII character string to call the identifier space. +.It Fa low +The lower end of an identifier space. This value is included in the +range. +.It Fa high +The upper end of an identifier space. This value is excluded in the +range. +.El +.Sh DESCRIPTION +The +.Sy id_space +suite of functions is used to create and manage identifier spaces. An +identifier space allows the system to manage a range of identifiers. It +tracks what values have been used and which values have not been used +and has different ways of allocating values from the identifier space. +.Pp +Identifier spaces are often used by device drivers to manage ranges of +numeric identifiers that may be disjoint. A common use case for +identifier spaces is to manage the set of allocated minor numbers for a +device driver. +.Ss Creating, Expanding and Destroying Identifier Spaces +To create an identifier space, the +.Fn id_space_create +function should be used. A name for the id space must be passed in the +.Fa name +argument. It should be unique. For device drivers, often combining the +name of the driver and the instance from the +.Xr ddi_get_instance 9F +function results in a unique name. +.Pp +The values of +.Fa low +and +.Fa high +describe the range of the identifier space. The range is inclusive on +the low end and exclusive on the high end. Mathematically, this would be +represented as +.Pf [ Fa low , +.Fa high Ns ). +.Pp +Once the +.Fn id_space_create +function has been successfully called, the returned identifier space can +be used to allocate and manage identifiers. +.Pp +Once an identifier space has been created, additional ranges of +identifiers can be added. This process allows for disjoint ranges of +values to be added to a single identifier space. The +.Fn id_space_extend +function is used to do this, and it adds the range +.Fa low +to +.Fa high +to the identifier space. The range follows the same rules as with the +.Fn id_space_create +function. +It is inclusive of +.Fa low +and is exclusive of +.Fa high . +.Pp +Finally, when an identifier space is no longer being used and all of its +identifiers have been freed, the caller should call the +.Fn id_space_destroy +function to destroy the id space +.Fa idspace . +.Pp +All three of these functions, +.Fn id_space_create , +.Fn id_space_extend , +and +.Fn id_space_destory +may block. They should only be called from a context where it's safe for +it to block. This is logically the equivalent of calling +.Xr kmem_alloc 9F +with the flag +.Dv KMEM_SLEEP . +.Ss Allocating Identifiers +Once an id space has been created with the +.Fn id_space_create +function, identifiers can be allocated from the space. There are three +different strategies for allocating an identifier: +.Bl -enum +.It +Allocating an identifier using the standard algorithm that attempts to +use the next identifier first. +.It +Allocating an identifier using a first fit algorithm. These are +functions with +.Em ff +in the name. Using this will tend to keep the allocated id space more +compressed. +.It +Allocating a specific id. +.El +.Pp +In addition, identifiers can be allocated in both a blocking and +non-blocking fashion. When functions with the +.Sy _nosleep +prefix are used, they are non-blocking. If no identifier is available, +they will return an error. +.Pp +The +.Fn id_alloc +function will allocate the next identifier. The +.Fn id_alloc_nosleep +function uses the same algorithm as +.Fn id_alloc , +but will fail rather than block. +.Pp +The +.Fn id_allocff +function will allocate the first available identifier. The +.Fn id_allocff_nosleep +function uses the same algorithm as +.Fn id_allocff , +but will fail rather than block. +.Pp +The +.Fn id_alloc_specific_nosleep +function attempts to allocate the specific identifier +.Fa id +from the specified identifier space. If +.Fa id +has already been allocated, then the function will fail. +.Ss Freeing Identifiers +Every allocated identifier must eventually be freed and returned to the +identifier space. To free an identifier, use the +.Fn id_free +function, specifying the identifier in +.Fa id +and the identifier space it came from in +.Fa id_space . +It is a programmer error to call the +.Fn id_free +function on an identifier that has not been allocated. +.Sh CONTEXT +In general, all the functions listed here may be executed in either +.Sy user , +.Sy kernel , +or +.Sy interrupt +context. However, the functions +.Fn id_space_create , +.Fn id_space_destroy , +.Fn id_space_extend , +.Fn id_alloc , +and +.Fn id_allocff +must be called from a context where it is safe to block and sleep. If +the caller is not in such a context, then it must only use the +.Sy '_nosleep' +functions. +.Sh RETURN VALUES +Upon successful completion, the +.Fn id_space_create +function returns a pointer to an identifier space. Otherwise, +.Dv NULL +is returned to indicate that the identifier space could not be created. +.Pp +The +.Fn id_alloc +and +.Fn id_allocff +functions always return an identifier that's in the range of the +specified identifier space. +.Pp +Upon successful completion, the +.Fn id_alloc_nosleep , +.Fn id_allocff_nosleep , +and +.Fn id_alloc_specific_nosleep +functions will return an identifier that's in the range of the specified +identifier space. Otherwise, +.Sy -1 +is returned to indicate that no identifier was available, or in the case +of the +.Fn id_alloc_specific_nosleep +function, that the specified identifier was not available. +.Sh SEE ALSO +.Xr kmem_alloc 9F , +.Xr rmallocmap 9F diff --git a/usr/src/man/man9f/ldi_add_event_handler.9f b/usr/src/man/man9f/ldi_add_event_handler.9f index 2f7d22f160..dad4420934 100644 --- a/usr/src/man/man9f/ldi_add_event_handler.9f +++ b/usr/src/man/man9f/ldi_add_event_handler.9f @@ -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 LDI_ADD_EVENT_HANDLER 9F "Aug 21, 2007" +.TH LDI_ADD_EVENT_HANDLER 9F "April 9, 2016" .SH NAME ldi_add_event_handler \- add NDI event service callback handler .SH SYNOPSIS @@ -17,11 +17,9 @@ ldi_add_event_handler \- add NDI event service callback handler .fi .SH INTERFACE LEVEL -.sp .LP Obsolete .SH PARAMETERS -.sp .ne 2 .na \fB\fIldi_handle_t lh\fR\fR @@ -75,7 +73,6 @@ Registration id must be saved and used when calling .RE .SH DESCRIPTION -.sp .LP This function is obsolete and is only maintained for compatibility. Use of this function is strongly discouraged. For equivalent functionality provided by new @@ -84,7 +81,7 @@ interfaces, see \fBldi_ev_get_cookie\fR(9F) and .sp .LP The \fBldi_add_event_handler()\fR function adds a callback handler to be -invoked at the occurance of the event specified by the cookie. Adding a +invoked at the occurrence of the event specified by the cookie. Adding a callback handler is also known as subscribing to an event. Upon successful subscription, the handler is invoked when the event occurs. You can unregister the handler by using \fBldi_remove_event_handler\fR(9F). @@ -135,7 +132,6 @@ callback function. .RE .SH RETURN VALUES -.sp .ne 2 .na \fB\fBDDI_SUCCESS\fR\fR @@ -155,12 +151,10 @@ or a bad cookie. .RE .SH CONTEXT -.sp .LP The \fBldi_add_event_handler()\fR function can be called from user and kernel contexts only. .SH SEE ALSO -.sp .LP \fBldi_ev_get_cookie\fR(9F), \fBldi_ev_register_callbacks\fR(9F), \fBldi_get_eventcookie\fR(9F), \fBldi_remove_event_handler\fR(9F) @@ -168,7 +162,6 @@ contexts only. .LP \fIWriting Device Drivers\fR .SH NOTES -.sp .LP Layered drivers must remove all registered callback handlers for a device instance, represented by the layered handle, by calling diff --git a/usr/src/man/man9f/ldi_remove_event_handler.9f b/usr/src/man/man9f/ldi_remove_event_handler.9f index f5593116ec..4449cf71c8 100644 --- a/usr/src/man/man9f/ldi_remove_event_handler.9f +++ b/usr/src/man/man9f/ldi_remove_event_handler.9f @@ -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 LDI_REMOVE_EVENT_HANDLER 9F "Aug 21, 2007" +.TH LDI_REMOVE_EVENT_HANDLER 9F "April 9, 2016" .SH NAME ldi_remove_event_handler \- remove an NDI event service callback .SH SYNOPSIS @@ -16,11 +16,9 @@ ldi_remove_event_handler \- remove an NDI event service callback .fi .SH INTERFACE LEVEL -.sp .LP Obsolete .SH PARAMETERS -.sp .ne 2 .na \fB\fIldi_handle_t lh\fR\fR @@ -41,7 +39,6 @@ upon successful registration. .RE .SH DESCRIPTION -.sp .LP This function is obsolete and is only maintained for compatibility. Use of this function is strongly discouraged. For equivalent functionality provided by new @@ -52,9 +49,8 @@ interfaces, see \fBldi_ev_register_callbacks\fR(9F) and The \fBldi_remove_event_handler()\fR function removes the callback handler specified by the registration ID (\fIldi_callback_id_t\fR). Upon successful removal, the callback handler is removed from the system and is not invoked at -the event occurance. +the event occurrence. .SH RETURN VALUES -.sp .ne 2 .na \fB\fBDDI_SUCCESS\fR\fR @@ -73,11 +69,9 @@ Failed to remove callback handler. .RE .SH CONTEXT -.sp .LP This function can be called from user and kernel contexts only. .SH SEE ALSO -.sp .LP \fBldi_ev_register_callbacks\fR(9F), \fBldi_ev_remove_callbacks\fR(9F), \fBldi_add_event_handler\fR(9F), \fBldi_get_eventcookie\fR(9F) diff --git a/usr/src/man/man9f/scsi_ifgetcap.9f b/usr/src/man/man9f/scsi_ifgetcap.9f index 758c58baf1..a6dabf72b0 100644 --- a/usr/src/man/man9f/scsi_ifgetcap.9f +++ b/usr/src/man/man9f/scsi_ifgetcap.9f @@ -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 SCSI_IFGETCAP 9F "May 24, 2014" +.TH SCSI_IFGETCAP 9F "April 9, 2016" .SH NAME scsi_ifgetcap, scsi_ifsetcap \- get/set SCSI transport capability .SH SYNOPSIS @@ -24,11 +24,9 @@ scsi_ifgetcap, scsi_ifsetcap \- get/set SCSI transport capability .fi .SH INTERFACE LEVEL -.sp .LP Solaris DDI specific (Solaris DDI). .SH PARAMETERS -.sp .ne 2 .na \fB\fIap\fR\fR @@ -65,7 +63,6 @@ Determines if all targets or only the specified target is affected. .RE .SH DESCRIPTION -.sp .LP The \fBscsi_ifsetcap()\fR function is used by target drivers to set the capabilities of the host adapter driver. The \fIcap\fR pointer is a name-value @@ -238,7 +235,7 @@ If geometry is not relevant or appropriate for the target disk, \fBscsi_ifgetcap()\fR can return \fB-1\fR to indicate that the geometry is not defined. For example, if the \fBHBA\fR BIOS supports Logical Block Addressing for the target disk, \fBscsi_ifgetcap()\fR returns \fB-1\fR. Attempts to -retreive the "virtual geometry" from the target driver, such as the +retrieve the "virtual geometry" from the target driver, such as the \fBDKIOCG_VIRTGEOM\fR ioctl, will fail. See \fBdkio\fR(7I) for more information about \fBDKIOCG_VIRTGEOM\fR. .RE @@ -334,7 +331,6 @@ the default value of the target driver is used for the \fBCDB\fR determination. .RE .SH RETURN VALUES -.sp .LP The \fBscsi_ifsetcap()\fR function returns: .sp @@ -406,11 +402,9 @@ if (scsi_ifsetcap(&devp->sd_address, "tagged-qing", 1, 1) == 1) { .in -2 .SH CONTEXT -.sp .LP These functions can be called from user, interrupt, or kernel context. .SH ATTRIBUTES -.sp .LP See \fBattributes\fR(5) for descriptions of the following attributes: .sp @@ -426,7 +420,6 @@ Interface Stability Committed .TE .SH SEE ALSO -.sp .LP \fBtran_reset\fR(9E), \fBscsi_hba_lookup_capstr\fR(9F), \fBscsi_reset\fR(9F), \fBscsi_reset_notify\fR(9F), \fBddi_dma_attr\fR(9S), diff --git a/usr/src/man/man9f/scsi_validate_sense.9f b/usr/src/man/man9f/scsi_validate_sense.9f index 6e24cc8eaf..efe75a55af 100644 --- a/usr/src/man/man9f/scsi_validate_sense.9f +++ b/usr/src/man/man9f/scsi_validate_sense.9f @@ -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 SCSI_VALIDATE_SENSE 9F "Jun 29, 2006" +.TH SCSI_VALIDATE_SENSE 9F "April 9, 2016" .SH NAME scsi_validate_sense \- find descriptor in SCSI sense data .SH SYNOPSIS @@ -18,11 +18,9 @@ scsi_validate_sense \- find descriptor in SCSI sense data .fi .SH INTERFACE LEVEL -.sp .LP Solaris DDI specific (Solaris DDI). .SH PARAMETERS -.sp .ne 2 .na \fB\fIsense_buffer\fR\fR @@ -51,7 +49,6 @@ Returns additional properties of the sense data. .RE .SH DESCRIPTION -.sp .LP The \fBscsi_validate_sense()\fR function returns the format of the sense data contained in the provided sense buffer. If the response code field in the sense @@ -81,11 +78,10 @@ sense data. .RS 20n The sense data contained in the buffer relates to an error that has occurred during the processing of a successfully completed command, such as a cached -write that could not be commited to the media. +write that could not be committed to the media. .RE .SH RETURN VALUES -.sp .ne 2 .na \fB\fBSENSE_UNUSABLE\fR\fR @@ -114,12 +110,10 @@ The sense data in the buffer is in "descriptor format". .RE .SH CONTEXT -.sp .LP The \fBscsi_validate_sense()\fR function can be called from user or interrupt context. .SH SEE ALSO -.sp .LP \fBscsi_ext_sense_fields\fR(9F), \fBscsi_find_sense_descr\fR(9F), \fBscsi_sense_asc\fR(9F), \fBscsi_sense_ascq\fR(9F), diff --git a/usr/src/man/man9f/scsi_vu_errmsg.9f b/usr/src/man/man9f/scsi_vu_errmsg.9f index 59d15f393b..0d2ead1e18 100644 --- a/usr/src/man/man9f/scsi_vu_errmsg.9f +++ b/usr/src/man/man9f/scsi_vu_errmsg.9f @@ -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 SCSI_VU_ERRMSG 9F "Jan 16, 2006" +.TH SCSI_VU_ERRMSG 9F "April 9, 2016" .SH NAME scsi_vu_errmsg \- display a SCSI request sense message .SH SYNOPSIS @@ -21,11 +21,9 @@ scsi_vu_errmsg \- display a SCSI request sense message .fi .SH INTERFACE LEVEL -.sp .LP Solaris DDI specific (Solaris DDI). .SH PARAMETERS -.sp .LP The following parameters are supported: .sp @@ -126,7 +124,6 @@ possible and \fINULL\fR if no decoding is possible. .RE .SH DESCRIPTION -.sp .LP This function is very similar to \fBscsi_errmsg\fR(9F) but allows decoding of vendor-unique ASC/ASCQ and FRU information. @@ -217,7 +214,6 @@ For a basic SCSI disk, the following list is appropriate: .in -2 .SH CONTEXT -.sp .LP The \fBscsi_vu_errmsg()\fR function may be called from user, interrupt, or kernel context. @@ -228,7 +224,7 @@ kernel context. .in +2 .nf struct scsi_asq_key_strings cd_slist[] = { - 0x81, 0, "Logical Unit is inaccessable", + 0x81, 0, "Logical Unit is inaccessible", -1, 0, NULL, }; @@ -252,13 +248,12 @@ WARNING: /sbus@1,f8000000/esp@0,800000/sd@1,0 (sd1): Requested Block: 23936 Error Block: 23936 Vendor: XYZ Serial Number: 123456 Sense Key: Unit Attention - ASC: 0x81 (Logical Unit is inaccessable), ASCQ: 0x0 + ASC: 0x81 (Logical Unit is inaccessible), ASCQ: 0x0 FRU: 0x11 (replace LUN 1, located in slot 1) .fi .in -2 .SH SEE ALSO -.sp .LP \fBcmn_err\fR(9F), \fBscsi_errmsg\fR(9F), \fBscsi_log\fR(9F), \fBscsi_errmsg\fR(9F), \fBscsi_asc_key_strings\fR(9S), \fBscsi_device\fR(9S), |