'\" te
.\" Copyright (c) 2002, Sun Microsystems, Inc.
.\" 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 hdio 7I "13 Aug 2002" "SunOS 5.11" "Ioctl Requests"
.SH NAME
hdio \- SMD and IPI disk control operations
.SH SYNOPSIS
.LP
.nf
#include <sys/hdio.h> 
.fi

.SH DESCRIPTION
.LP
Note -
.sp
.RS 2
The SMC and IPI drivers have been discontinued. \fBdkio\fR(7I) is now the
preferred method for retrieving disk information.
.RE
.sp
.LP
The SMD and IPI disk drivers supplied with this release support a set of
\fBioctl\fR(2) requests for diagnostics and bad sector information. Basic to
these  \fBioctl()\fR requests are the definitions in <\fBsys/hdio.h\fR>.
.SH IOCTLS
.sp
.ne 2
.mk
.na
\fB\fBHDKIOCGTYPE\fR\fR
.ad
.RS 15n
.rt  
The argument is a pointer to a \fBhdk_type\fR structure (described below).
This \fBioctl()\fR gets specific information from the hard disk.
.RE

.sp
.ne 2
.mk
.na
\fB\fBHDKIOCSTYPE\fR\fR
.ad
.RS 15n
.rt  
The argument is a pointer to a \fBhdk_type\fR structure (described below).
This \fBioctl()\fR sets specific information about the hard disk.
.RE

.sp
.in +2
.nf
/*
 * Used for drive info
 */
struct hdk_type {
 ushort_t  hdkt_hsect;    /* hard sector count (read only) */
 ushort_t  hdkt_promrev;  /* prom revision (read only) */
 uchar_t   hdkt_drtype;   /* drive type (ctlr specific) */
 uchar_t   hdkt_drstat;   /* drive status (ctlr specific, ro) */
};
.fi
.in -2

.sp
.ne 2
.mk
.na
\fB\fBHDKIOCGBAD\fR\fR
.ad
.RS 14n
.rt  
The argument is a pointer to a \fBhdk_badmap\fR structure (described below).
This \fBioctl()\fR is used to get the bad sector map from the disk.
.RE

.sp
.ne 2
.mk
.na
\fB\fBHDKIOCSBAD\fR\fR
.ad
.RS 14n
.rt  
The argument is a pointer to a \fBhdk_badmap\fR structure (described below).
This \fBioctl()\fR is used to set the bad sector map on the disk.
.RE

.sp
.in +2
.nf
/*
 * Used for bad sector map
 */
struct hdk_badmap {
	caddr_t	hdkb_bufaddr;	/* address of user's map buffer */
};
.fi
.in -2

.sp
.ne 2
.mk
.na
\fB\fBHDKIOCGDIAG\fR\fR
.ad
.RS 15n
.rt  
The argument is a pointer to a \fBhdk_diag\fR structure (described below).
This \fBioctl()\fR gets the most recent command that failed along with the
sector and error number from the hard disk.
.RE

.sp
.in +2
.nf
/*
 * Used for disk diagnostics
 */
struct hdk_diag {
 ushort_t	hdkd_errcmd;  /* most recent command in error */
 daddr_t	hdkd_errsect; /* most recent sector in error */
 uchar_t	hdkd_errno;   /* most recent error number */
 uchar_t	hdkd_severe;  /* severity of most recent error */
};
.fi
.in -2

.SH SEE ALSO
.sp
.LP
\fBioctl\fR(2), \fBdkio\fR(7I)