'\" te
.\" Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved.
.TH HBA_RefreshInformation 3HBAAPI "1 Sep 2003" "SunOS 5.11" "Common Fibre Channel HBA Information Library Functions"
.SH NAME
HBA_RefreshInformation, HBA_RefreshAdapterConfiguration \- refresh information for a specific HBA
.SH SYNOPSIS
.LP
.nf
cc [ \fIflag\fR\&.\|.\|. ] \fIfile\fR\&.\|.\|. \fB-lHBAAPI\fR [ \fIlibrary\fR\&.\|.\|. ]
#include <hbaapi.h>

\fBvoid\fR \fBHBA_RefreshInformation\fR(\fBHBA_HANDLE\fR \fIhandle\fR);
.fi

.LP
.nf
\fBvoid\fR \fBHBA_RefreshAdapterConfiguration\fR(\fBvoid\fR);
.fi

.SH PARAMETERS
.sp
.ne 2
.mk
.na
\fB\fIhandle\fR\fR
.ad
.RS 10n
.rt  
an open handle returned from \fBHBA_OpenAdapter\fR(3HBAAPI)
.RE

.SH DESCRIPTION
.sp
.LP
The \fBHBA_RefreshInformation()\fR function requests that the underlying VSL reload all information about the given HBA.  This function should be called whenever any function returns \fBHBA_STATUS_ERROR_STALE_DATA\fR, or if an index that was previously valid returns \fBHBA_STATUS_ERROR_ILLEGAL_INDEX\fR. Because the underlying VSL can reset all indexes relating to the HBA, all old index values must be discarded by the caller.
.sp
.LP
The \fBHBA_RefreshAdapterConfiguration()\fR function updates information about the HBAs present on the system. This function does not change any of the relationships between the HBA API and adapters that have not been reconfigured.  HBA handles continue to refer to the same HBA even if it is no longer installed. The HBA name or index assigned by the library remains assigned to the same HBA even if it has been removed and reinstalled, as long as the bus position, WWN, and OS device have not changed. Adapter that have been removed and not replaced cannot have their HBA handles, HBA names, and HBA indexes reassigned. Calls to these adapters will generate \fBHBA_STATUS_ERROR_UNAVAILABLE\fR.
.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
Interface StabilityCommitted
_
T{
Standard: FC-HBA Version 4 (API version 2)
T}
_
MT-LevelSafe
_
StandardFC-MI 1.92 (API version 1)
.TE

.SH SEE ALSO
.sp
.LP
\fBHBA_OpenAdapter\fR(3HBAAPI), \fBlibhbaapi\fR(3LIB), \fBattributes\fR(5)
.sp
.LP
T11 FC-MI Specification