usr/src/lib/sun_fc/common/Sun_fcOpenTgtAdapter.cc

   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_fcOpenTgtAdapter(char *name) {
  46         Trace log("Sun_fcOpenTgtAdapter");
  47         if (name == NULL) {
  48             log.userError("Null argument");
  49             return (HANDLE_ERROR);
  50         }
  51
  52         try {
  53             return (HBAList::instance()->openTgtHBA(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