Free Knowledge Resources


Linux Manual Pages


Free Software * Books

Source Code

Free Media

Linux

libzfcphbaapi(3)


NAME

   libzfcphbaapi - an implementation of FC-HBA

SYNOPSIS

   #include <hbaapi.h>

   cc file.c -lHBAAPI

   When linking to the SNIA HBA API wrapper package (default)

   or

   cc file.c -lzfcphbaapi

DESCRIPTION

Introduction
   The  libzfcphbaapi  is part of an implementation of FC-HBA for the ZFCP
   device driver. The ZFCP device driver is a FCP device driver for  Linux
   on  System  z.  The  whole implementation of FC-HBA for the ZFCP device
   driver is called ZFCP HBA API. It is implemented in libzfcphbaapi  -  a
   shared library which provides the API defined in FC-HBA.


Compatibility
   ZFCP   HBA   API   Library   supports   the  API  functions  listed  in
   SupportedHBAAPIs(3) All other API functions of FC-HBA return the status
   HBA_STATUS_ERROR_NOT_SUPPORTED   if   possible   and   are   listed  in
   UnSupportedHBAAPIs(3)


Restrictions and Peculiarities
   For ZFCP HBA API the following restrictions and pecularities apply:

   - Only adapters, ports and units can be accessed that are configured in
   the  ZFCP  device  dirver.  This is due to internal restrictions of the
   ZFCP device driver and due to the fact that the adapter might be shared
   between several VM guests.

   - If SCSI commands are send to a target port, the well known lun (WLUN)
   for the report luns command will  be  attached  and  detached.  If  the
   storage server does not support that WLUN, lun scanning will fail.

   -   The   function   HBA_GetFcpTargetMapping()   does   not  return  an
   OSDeviceName in struct HBA_FCPTargetMapping. This is conform to  FC-HBA
   since this field is optional.

   -  Because  the ZFCP device driver does not support Single Byte Command
   Code  Sets   Connections,   the   functions   HBA_GetSBTargetMapping(),
   HBA_GetSBStatistics()  and  HBA_SBDskGetCapacity() are not supported by
   libzfcphbaapi.


Installation
   A source RPM and/or binary RPM  "lib-zfcp-hbaapi"  should  be  provided
   which  will  install  the ZFCP HBA API Library called libzfcphbaapi.so.
   The corresponding header file hbaapi.h will be supplied by the SNIA HBA
   API  library  wrapper  package  when compiled as a vendor library. When
   not, an own version of the header file will be installed.


Environment Variables
   To log error situations in libzfcphbaapi two environment variables  are
   used:

   - LIB_ZFCP_HBAAPI_LOG_LEVEL - specifies log level

        - if not set or set to 0, logging is disabled (default)

        - if set to value > 0, logging is enabled

   - LIB_ZFCP_HBAAPI_LOG_FILE - specifies file where log output is written
   to

        - if not set, stderr is used

        - if set, specified file is used for log output


Reference
   FC-HBA: ANSI INCITS 386-2004, The T11 Technical Committee.  Information
   Technology - Fibre Channel HBA API


SEE ALSO
   SupportedHBAAPIs(3), UnSupportedHBAAPIs(3).



	    

	    

	
	    
	    

	      
	      

	      
	    

	    

	
	    
      
Opportunity

      

	
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity. 
	

	

	  Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
	

	

	
	
	

	  
	  

	  
	

	

	
	
      
Free Software

      

	

	  Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
	

	


	

	  Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
	

	

	      

	

	  
	  

	  
	

	

	
	
      
Free Books

      

	

	  The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
	

	

	

	  Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the  GNU source code repositories to download the source.
	

	

	

	

	  
	  

	  
	

	

	

      
Education

      

	      
Study at Harvard, Stanford or MIT -
	  Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
	
     
	

	
	

	  Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts. 
	

	

      

      

	
	  birds banner