xref: /illumos-gate/usr/src/lib/sun_fc/common/Sun_fcGetAdapterName.cc (revision fcf3ce441efd61da9bb2884968af01cb7c1452cc)
1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License (the "License").
6  * You may not use this file except in compliance with the License.
7  *
8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9  * or http://www.opensolaris.org/os/licensing.
10  * See the License for the specific language governing permissions
11  * and limitations under the License.
12  *
13  * When distributing Covered Code, include this CDDL HEADER in each
14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15  * If applicable, add the following below this CDDL HEADER, with the
16  * fields enclosed by brackets "[]" replaced with your own identifying
17  * information: Portions Copyright [yyyy] [name of copyright owner]
18  *
19  * CDDL HEADER END
20  */
21 /*
22  * Copyright 2008 Sun Microsystems, Inc.  All rights reserved.
23  * Use is subject to license terms.
24  */
25 
26 
27 
28 #include "HBAList.h"
29 #include "Trace.h"
30 #include "Exceptions.h"
31 #ifdef	__cplusplus
32 extern "C" {
33 #endif
34 
35 /**
36  * @memo	    Get the adapters name
37  * @precondition    name parameter must be sufficient length to fit the name
38  * @postcondition   name contains the name of the given adapter
39  * @return	    HBA_STATUS_OK on success, or other error code
40  * @param	    index	the index to which adapter to retrieve the name
41  * @param	    name	buffer to which the adapter name will be placed
42  *
43  * @doc
44  * Returns the text string which describes this adapter and which is used to
45  * open the adapter with the library.
46  */
47 HBA_STATUS Sun_fcGetAdapterName(HBA_UINT32 index, char *name) {
48 	Trace log("Sun_fcGetAdapterName");
49 	if (name == NULL) {
50 	    log.userError(
51 		"NULL name pointer");
52 	    return (HBA_STATUS_ERROR_ARG);
53 	}
54 	try {
55 	    HBAList* list = HBAList::instance();
56 	    std::string sname = list->getHBAName(index);
57 	    strcpy(name, sname.c_str());
58 	    return (HBA_STATUS_OK);
59 	} catch (HBAException &e) {
60 	    return (e.getErrorCode());
61 	} catch (...) {
62 	    log.internalError(
63 		"Uncaught exception");
64 	    return (HBA_STATUS_ERROR);
65 	}
66 }
67 
68 #ifdef	__cplusplus
69 }
70 #endif
71