xref: /illumos-gate/usr/src/lib/sun_fc/common/Sun_fcOpenAdapter.cc (revision 2bbdd445a21f9d61f4a0ca0faf05d5ceb2bd91f3)
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 "Trace.h"
29 #include "HBAList.h"
30 #include "Handle.h"
31 #include "Exceptions.h"
32 
33 #define	    HANDLE_ERROR 0
34 #ifdef	__cplusplus
35 extern "C" {
36 #endif
37 
38 /**
39  * @memo	    Opens a named adapter.
40  * @precondition    Library already loaded
41  * @postcondition   Open handle must be closed at a later point in time
42  * @return	    An open handle, or (0) on error
43  * @param	    name The name of the adapter to open
44  */
45 HBA_HANDLE Sun_fcOpenAdapter(char *name) {
46 	Trace log("Sun_fcOpenAdapter");
47 	if (name == NULL) {
48 	    log.userError("Null argument");
49 	    return (HANDLE_ERROR);
50 	}
51 
52 	try {
53 	    return (HBAList::instance()->openHBA(name)->getHandle());
54 	} catch (HBAException &e) {
55 	    return (0);
56 	} catch (...) {
57 	    log.internalError("Uncaught exception");
58 	    return (0);
59 	}
60 }
61 #ifdef	__cplusplus
62 }
63 #endif
64