xref: /titanic_50/usr/src/lib/sun_fc/common/Sun_fcGetAdapterName.cc (revision 356f72340a69936724c69f2f87fffa6f5887f885)
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 #include <cstring>
32 
33 #ifdef	__cplusplus
34 extern "C" {
35 #endif
36 
37 /**
38  * @memo	    Get the adapters name
39  * @precondition    name parameter must be sufficient length to fit the name
40  * @postcondition   name contains the name of the given adapter
41  * @return	    HBA_STATUS_OK on success, or other error code
42  * @param	    index	the index to which adapter to retrieve the name
43  * @param	    name	buffer to which the adapter name will be placed
44  *
45  * @doc
46  * Returns the text string which describes this adapter and which is used to
47  * open the adapter with the library.
48  */
49 HBA_STATUS Sun_fcGetAdapterName(HBA_UINT32 index, char *name) {
50 	Trace log("Sun_fcGetAdapterName");
51 	if (name == NULL) {
52 	    log.userError(
53 		"NULL name pointer");
54 	    return (HBA_STATUS_ERROR_ARG);
55 	}
56 	try {
57 	    HBAList* list = HBAList::instance();
58 	    std::string sname = list->getHBAName(index);
59 	    strcpy(name, sname.c_str());
60 	    return (HBA_STATUS_OK);
61 	} catch (HBAException &e) {
62 	    return (e.getErrorCode());
63 	} catch (...) {
64 	    log.internalError(
65 		"Uncaught exception");
66 	    return (HBA_STATUS_ERROR);
67 	}
68 }
69 
70 #ifdef	__cplusplus
71 }
72 #endif
73