{"id":18896392,"url":"https://github.com/openmainframeproject/zfcp-hbaapi","last_synced_at":"2026-02-28T05:30:15.802Z","repository":{"id":105092740,"uuid":"232224733","full_name":"openmainframeproject/zfcp-hbaapi","owner":"openmainframeproject","description":"Mirror of the Linux on IBM Z lib-zfcp-hbaapi \"zfcp HBA API library\" package. (HBA is short for \"Host Bus Adapter\".)","archived":false,"fork":false,"pushed_at":"2020-01-07T02:20:44.000Z","size":451,"stargazers_count":2,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-12-31T08:14:14.261Z","etag":null,"topics":["linux","mainframe","mirror","s390x"],"latest_commit_sha":null,"homepage":"https://www.ibm.com/developerworks/linux/linux390/zfcp-hbaapi.html","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/openmainframeproject.png","metadata":{"files":{"readme":"README","changelog":"ChangeLog","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-01-07T02:19:38.000Z","updated_at":"2023-09-19T02:15:22.000Z","dependencies_parsed_at":null,"dependency_job_id":"a54b8f6d-b8a9-462d-b2db-7fa441a5c6e9","html_url":"https://github.com/openmainframeproject/zfcp-hbaapi","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openmainframeproject%2Fzfcp-hbaapi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openmainframeproject%2Fzfcp-hbaapi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openmainframeproject%2Fzfcp-hbaapi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openmainframeproject%2Fzfcp-hbaapi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openmainframeproject","download_url":"https://codeload.github.com/openmainframeproject/zfcp-hbaapi/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239871062,"owners_count":19710839,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["linux","mainframe","mirror","s390x"],"created_at":"2024-11-08T08:33:45.594Z","updated_at":"2026-02-28T05:30:15.750Z","avatar_url":"https://github.com/openmainframeproject.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"DESCRIPTION\n-----------\n\nThis is lib-zfcp-hbaapi (zfcp HBA API library) Version 2.2.0. It is part of an\nimplementation of FC-HBA for the ZFCP device driver.\n\nThe zfcp device driver is a FCP device driver for Linux on System z.\nThe whole implementation of FC-HBA for the zfcp device driver is called zfcp\nHBA API. It is a shared library which provides the API defined in FC-HBA.\n\nVersion 2.2.0 contains additional port speed capabilities.\nVersion 2.1.1 contains bugfixes and minor adaptations to build in recent Linux\nenvironments.\nVersion 2.1 extends version 2.0 with some additional features and \ntwo utilities (zfcp_ping, zfcp_show). These utilities are useful to discover\na storage area network (SAN). Refer to the respective man-pages for \nfurther details.\nVersion 2.0 is a complete re-implementation.\nVersion 1.4 of lib-zfcp-hbaapi did not have a shared version of the library;\nlibzfcphbaapi was linked statically against the san_disc tool.  With Version 2,\nthe shared version of the library is available again.\nThe device file for the communication with the zfcp kernel module is not needed\nany more. The only interfaces utilized now are the sysfs and the generic scsi\ndevices.\n\nREQUIREMENTS\n------------\n\nSoftware:\nlibsgutils\ndoxygen for developer documentation\nLinux Kernel 2.6.27 (or later)\nLinux kernel 2.6.36 (or later) required for event triggers.\n\nHardware:\nThe zfcp HBA API support was first available on IBM eServer zSeries 990\nprocessors with a microcode level (MCL) that includes the enhancements of\nOctober 31, 2003. Please ensure to use the latest available microcode level.\nAll newer models are supported.\n\nINSTALLATION\n------------\n\nThe package doxygen is required for the complete build of the sources.\n\nGeneric installation instructions are given in file INSTALL.\nTo build and install lib-zfcp-hbaapi, use the following steps:\n\n    ./configure\n    make\n    make docs\n    make install\n\nConfiguration options:\n\n--enable-backtrace=yes|no\tdefault: no\n\tEnable backtrace printing on mutex errors.\n\t\n--enable-vendor-lib=yes|no\tdefault: yes\n\tBuilds the library as a vendor specific library to be used with the\n\tcommon SNIA library (see http://hbaapi.sourceforge.net). All entry\n\tpoints will be in the common library (libHBAAPI.so) and the\n\tcommon library header file (hbaapi.h) needs to be used.\n\tIf the common library is not available, libzfcphbaapi can be built\n\tstandalone, enabling applications to directly link against\n\tlibzfcphbaapi.so (--enable-vendor-lib=no)\n\tIn that case, an own copy of hbaapi.h will be installed.\n\n--enable-debug=yes|no\t\tdefault: no\n\tEnable debug information.\n\n--enable-docs=yes|no\t\tdefault: yes\n\tBuilds additional developer documentation and man pages via doxygen\n\twhich will be installed as well.\n\nlib-zfcp-hbaapi installs by default in /usr/local/lib. The HBA API\nheader file is installed in /usr/local/include (only if compiled with\n--enable-vendor-lib=no, otherwise no header file will be installed) and\ndocumentation is installed in /usr/local/share/zfcp-hbaapi-2.x.\n\nThe library is named libzfcphbaapi.so. The HBA API header file is\nnamed hbaapi.h and should be included by applications that link\nagainst libzfcphbaapi.so. The header file will be supplied by the SNIA HBA API\n(see http://hbaapi.sourceforge.net) or by lib-zfcp-hbaapi, see paragraph above.\n\nCLEANING UP\n-----------\n\nThe following steps describe how to remove files that were generated during the\nbuild process.\n\nmake clean\n\tDeletes all object files an the doxygen documentation\n\nmake distclean\n\tDeletes all files generated during compilation\n\nmake maintainer-clean-local\n\tDeletes all files generated by the autotools. To generate them again,\n\trun \"./bootstrap\"\n\n\nSUPPORTED FUNCTIONS\n-------------------\n\nHBA_GetVersion\nHBA_LoadLibrary\nHBA_FreeLibrary\nHBA_RegisterLibrary\nHBA_RegisterLibraryV2\nHBA_GetNumberOfAdapters\nHBA_RefreshInformation\nHBA_RefreshAdapterConfiguration\nHBA_GetAdapterName\nHBA_OpenAdapter\nHBA_CloseAdapter\nHBA_GetAdapterAttributes\nHBA_GetAdapterPortAttributes\nHBA_GetDiscoveredPortAttributes\nHBA_GetPortStatistics\nHBA_GetFcpTargetMapping\nHBA_GetFcpTargetMappingV2\nHBA_SendScsiInquiry\nHBA_SendReportLUNs\nHBA_ScsiReportLUNsV2\nHBA_SendCTPassThru\nHBA_SendCTPassThruV2\nHBA_GetRNIDMgmtInfo\nHBA_SendRNID\nHBA_SendRNIDV2\nHBA_GetEventBuffer\n\n\nFor more information see man page libzfcphbaapi(3).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenmainframeproject%2Fzfcp-hbaapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenmainframeproject%2Fzfcp-hbaapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenmainframeproject%2Fzfcp-hbaapi/lists"}