svcadm(1M)을 검색하려면 섹션에서 1M 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.
HBA_GetFcpTargetMapping(3hbaapi)
Common Fibre Channel HBA Information Library Functions
HBA_GetFcpTargetMapping(3HBAAPI)
NAME
HBA_GetFcpTargetMapping, HBA_GetFcpTargetMappingV2 - retrieve mapping
between FCP-2 discovered devices and operating system SCSI information
SYNOPSIS
cc [ flag... ] file... -lHBAAPI [ library... ]
#include <hbaapi.h>
HBA_STATUS HBA_GetFcpTargetMapping(HBA_HANDLE handle,
HBA_FCPTARGETMAPPING *mapping);
HBA_STATUS HBA_GetFcpTargetMappingV2(HBA_HANDLE handle,
HBA_WWN hbaPortWWN, HBA_FCPTARGETMAPPINGV2 *mapping);
PARAMETERS
handle an open handle returned from HBA_OpenAdapter(3HBAAPI)
mapping a buffer in which to store the mapping entries. The map‐
ping->NumberOfEntries member must indicate the maximum
number of entries that will fit within the buffer. On
completion, the mapping->NumberOfEntries member indicates
the actual number of mapping entries for the HBA. This
value can be greater than the number of entries the buf‐
fer can store.
hbaPortWWN the Port Name of the local HBA Port for which the caller
is requesting target mappings.
DESCRIPTION
The HBA_GetFcpTargetMapping() function retrieves the current set of
mappings between FCP LUNs and SCSI LUNs for a given HBA port.
The HBA_GetFcpTargetMappingV2() function retrieves the current set of
mappings between FCP LUNs and SCSI LUNs for a given HBA. The mapping
also includes a Logical Unit Unique Identifier for each logical unit.
RETURN VALUES
The HBA_GetFcpTargetMappingV2() function returns the following values:
HBA_STATUS_ERROR_ILLEGAL_WWN
The port WWN specified by hbaPortWWN is not a valid port WWN on the
specified HBA
HBA_STATUS_ERROR_NOT_SUPPORTED
Target mappings are not supported on the HBA.
HBA_STATUS_ERROR
An error occurred.
The HBA_GetFcpTargetMapping() and HBA_GetFcpTargetMappingV2() functions
return the following values:
HBA_STATUS_OK
The HBA was able to retrieve information.
HBA_STATUS_ERROR_MORE_DATA
A larger buffer is required. The value of mapping->NumberOfEntries
after the call indicates the total number of entries available. The
caller should reallocate the buffer large enough to accommodate the
indicated number of entries and reissue the routine.
In the event that other error values are returned, the value of map‐
ping->NumberOfEntries after the call should be checked, and if greater
than the value before the call, a larger buffer should be allocated for
a retry of the routine.
ERRORS
See libhbaapi(3LIB) for general error status values.
EXAMPLES
Example 1 Return target mapping data.
The following example returns target mapping data. It initially allo‐
cates space for one target mapping. If the number of entries returned
is greater than the allocated space, a new buffer with sufficient space
is allocated and HBA_GetFcpTargetMapping() is called again.
map = (HBA_FCPTARGETMAPPING *)calloc(1,
sizeof (HBA_FCPTARGETMAPPING));
status = HBA_GetFcpTargetMapping(handle, map);
if (map->NumberOfEntries > 0) {
HBA_UINT32 noe = map->NumberOfEntries;
free(map);
map = (HBA_FCPTARGETMAPPING *)calloc (1,
sizeof (HBA_FCPTARGETMAPPING) +
(sizeof (HBA_FCPSCSIENTRY)*(noe - 1)));
map->NumberOfEntries = noe;
if ((status = HBA_GetFcpTargetMapping(handle, map)) !=
HBA_STATUS_OK) {
fprintf(stderr, " Failed to get target "
"mappings %d", status);
free(map);
} else {
printf(" FCP Mapping entries: \n");
for (cntr = 0;
cntr < map->NumberOfEntries;
cntr ++) {
printf(" Path(%d): \"%s\"\n", cntr,
map->entry[cntr].ScsiId.OSDeviceName);
}
}
}
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
TRIBUTE VALUE _ Interface StabilityCommitted _ T{ Standard: FC-HBA Ver‐
sion 4 (API version 2) T} _ MT-LevelSafe _ Standard FC-MI 1.92 (API
version 1)
SEE ALSO
HBA_OpenAdapter(3HBAAPI), libhbaapi(3LIB), attributes(7)
T11 FC-MI Specification
BUGS
The HBA_GetFcpTargetMapping() routine does not take a portindex to
define which port of a multi-ported HBA the command should apply to.
The behavior on multi-ported HBAs is vendor specific, and may result in
mappings or bindings for all ports being intermixed in the response
buffer. SNIA version 2 defines a HBA_GetFcpTargetMappingV2() which
takes a Port WWN as an argument. This fixes the bug with multi-ported
HBAs in HBA_GetFcpTargetMapping().
Oracle Solaris 11.4 29 Sept 2016
HBA_GetFcpTargetMapping(3HBAAPI)