Hsistatusnotavailible, Hsistatusnotready, Cmos | Intel ZT 4901

Redundant Host Function Return Values

HSI_STATUS_NOT_AVAILIBLE	The specified operation could not be
	completed because necessary
	functionality was not available at the
	time of the call.
HSI_STATUS_NOT_READY	The specified operation failed
	because the device was not ready to
	handle the operation
HSI_STATUS_NOT_SUPPORTED	The specified operation is not
	supported
HSI_STATUS_OBJECT_DOES_NOT_EXIST	The specified operation could not be
	completed because an object
	specified in input parameters did not
	exist.
HSI_STATUS_OPERATION_ABORTED	The specified operation was aborted
	/ canceled
HSI_STATUS_OPERATION_INTERRUPTED	The specified operation was
	interrupted by another operation
HSI_STATUS_OPERATION_NOT_APPLICABLE	The specified operation could not
	completed because the operation
	was not valid for the current device
	context or interface status.

HSI_STATUS_PENDING

HSI_STATUS_REQUEST_DENIED

HSI_STATUS_TIMEOUT

HSI_STATUS_UNABLE_TO_BUILD_UPT

HSI_STATUS_UNABLE_TO_COPY_APP_DATA

The operation was started but returned before being completed. The operation will be completed asynchronously.

The specified operation request was denied due to security reasons.

The operation timed out.

The Host’s Universal PCI Table failed to be populated properly.

The operation was unable to access the data due to an error coping the application data

HSI_STATUS_UNABLE_TO_LOCATE_P2P_BRIDGES	The Redundant Host driver was
	unable to locate the PCI-to-PCI
	bridges that allow the system master
	to access backplane devices.
HSI_STATUS_UNABLE_TO_MAP_CMOS	The Redundant Host was unable to
	successfully map the System
	Information table found in the
	CMOS.
HSI_STATUS_UNABLE_TO_REASSIGN_RESOURCE	The Redundant Host driver was
S	unable to successfully reassign the
	backplane devices allocated
	resources.

110	High Availability Software for the Intel® NetStructureTM ZT 4901 Technical Product Specification

Image 110

Intel ZT 4901 manual Hsistatusnotavailible, Hsistatusnotready, Hsistatusobjectdoesnotexist, Hsistatusoperationaborted, Cmos

Contents

Technical Product Specification Intel NetStructureTM ZT 4901 High Availability SoftwarePage Contents Hot Swap API Demonstration Utilities Figures Tables Revision History Date Revision Description This page intentionally left blank Document Organization Document Organization Following terms are commonly used in this document IntroductionTerminology Introduction Introduction High Availability Hardware Approach CIC Processor BoardsPCI RSS Processor Board Block Diagram Bridge Mezzanine RSS Host with Bridge Mezzanine Block Diagram Backplane Host application System Management Backplane Device Drivers High-Availability Software ApproachHost Application System Management Backplane Device Drivers Goals of the Host Application ServiceabilityHost Application Software Portability Division of Labor Host Application Software Development Issues Code Modularity Graceful SwitchoverHardened Applications Ipmi API System ManagementRedundant Host API Hot Swap API Fault ConfigurationBaseboard Management Controller Firmware Enhancements Slot Control API Isolation Strategies Channel Definitions for ZT RH Channel Get RH BMC Address Ipmi RH Channel CommandsRH Channel Enabled Request Response This page intentionally left blank High Availability CompactPCI Device Drivers Device Driver Design Quiesced Device Driver StatesInitialization Activation Device Adding High-Availability FunctionalityFind Removed Add Device Resume Operations Driver Synchronization Suspend OperationsRemove Device Summary Intel-Specific APIs RhGetHwDestinationHostAndResetRedundant Host API RhSetHostName Hsistatussuccess Redundant Host PICMG* 2.12 APIsRedundant Host API Hsistatusinvalidparameter Definitions and Types Following topics specify each of the interface functions Minoralarm Majoralarm Criticalalarm Rhalarmseverity RESETREQUIRED, Resetnotrequired Unknown Rhslotneedsreset Hsistatusno Datadetected Initialization/TerminationRhEnumerateInstances Hsistatusinsufficientbuffer InstanceId RhOpenRhOpen Char *InstanceId Optional OUT Rhhandle *pHandle RhEnumerateInstances RhClose in Rhhandle Handle RhCloseRhGetInstanceID Handle RhGetDomainCount Handle Handle of the current session PInstanceIDDomain and Host Information API RhGetDomainCount Rhhandle Handle OUT uint32 *pCount System RhGetDomainNumbersHandle Handle of the current session PCount RhGetDomainOwnership RhGetDomainSlotPath Character Domain is written as a null-terminated stringSlotPathLength HSISTATUSINSUFFICIENTBUFFER, this is the minimum Is placed RhGetDomainSlotCountRhGetDomainSlots RhGetSlotDomain RhGetCurrentHostNumber Rhhandle Handle OUT uint32 *pHost RhGetCurrentHostNumberRhGetHostCount Handle Handle of the current session PHostCount RhGetHostNumbersRhGetHostCount Rhhandle Handle OUT uint32 *pHostCount RhGetHostName RhSetHostAvailability False RhGetHostAvailability RhGetPhysicalSlotInformation Slot Information APIRhGetDomainAvailabilityToHost Rhslotdescriptor HsinosuchdeviceIf the specified slot is empty Devices directly placed in the physical slots + FunctionNumber for the corresponding PCI-PCI bridge RhGetSlotChildInformationSlotPath By two characters from the set ‘0’..’9’, ‘A’..’F’ Handle Handle of the current session PhysSlot If there are no child devices below the specified bridge PCI buses in the system Switchover API Switchover Scenarios and Theory of Operation Partially Cooperative Switchover RhPrepareForSwitchover Hostile Switchover Hsistatusrequestdenied RhCancelPrepareForSwitchover Hsistatussuccess returned in the case of success RhGetDomainSwConnectionStatus Invalid session handle or the specified slot does not exist RhPerformSwitchoverRhGetSlotSwConnectionStatus Value Rhnodestinationhost means no host should own RhSetHwDestinationHostHandle Handle of the current session DestinationHost Specified domains Rhnodestinationhost means no host owns the domains RhGetHwDestinationHost Notification, Reporting and AlarmsRhEnableDomainStateNotification During software connection and disconnection RhEnableSwitchoverNotificationDisconnecting RhEnableSwitchoverRequestNotification Switchovers in which it participates RhEnableUnsafeSwitchoverNotification Device in unsafe state Indicates is the depth of the device below the physical slot RhDisableNotification Handle Handle of the current session NotificationType Hot Swap API Hot Swap API ImbDeviceIoControl ImbOpenDriverImbCloseDriver Dword ImbSendTimedI2cRequestLpvoid Lpdword Accesnstatus ImbSendIpmiRequestImbGetAsyncMessage ImbUnregisterForAsyncMsgNotification ImbIsAsyncMessageAvailableImbRegisterForAsyncMsgNotification EventId EventID handle returned once registered ImbGetLocalBmcAddr ImbSetLocalBmcAddr Byte ImbGetIpmiVersionByte imbGetIpmiVersion Current determined Ipmi version HsiCloseSlotControl Slot Control APIHsiOpenSlotControl Hsistatusnomemory Slot Control API HsiGetSlotCountHsiGetBoardPresent HsiGetBoardHealthy Hsistatusnodatadetected HsiGetSlotPower Healthy HsiSetSlotPower HsiGetSlotReset Slot Physical slot number HsiSetSlotResetHsistatusnotimplemented Hsiapidef Hsistatus HsiGetSlotM66EnableFalse 66 MHz operation is not enabled for the slot HsiSetSlotM66Enable Function HsiSetSlotEventCallbackHandle Handle of the current session Callback Returned if the arguments or handle is invalid Hsisloteventinfo Void *HSISLOTEVENTCALLBACKHsisloteventinfostruct User Interface Demonstration UtilitiesFunctional Description RH Interface Hardware Initiated Failovers Multiple Mode CapabilitiesSoftware Initiated Handovers Demonstration Utilities Host Domain Enumeration and Association Switchover FunctionsNotification, Reporting and Alarms Slot Information Isolation Strategy Fault ConfigurationIpmi Interface Hot Swap Interface HS Functional Description Slot Information Structure PCI Tree Information Retrieval Flags Slot Control Interface Slot State Demonstration Utilities Linux Software InstallationInstalling the Redundant Host Software Kit Patching and Rebuilding an RH-Enabled Kernel Installing RH Source RPMSource Installation Software Installation 1 /lib/modules/priBptd.o Configuring the Redundant Host InfrastructureMaking RH Configuration Changes 2 /lib/modules/slotcntrl.o 4 /CompactPCI-RH-1.0/app/bin VxWorks Tornado II Setup3 /CompactPCI-RH-1.0/app/lib RedundantHostFunctionReturnValuesB Redundant Host Function Return Values Hsistatusnosuchbridge Hsistatusnosysrhtablefound Hsistatusobjectdoesnotexist HsistatusnotavailibleHsistatusnotready Hsistatusoperationaborted Hsistatusunsupportedplatform HsistatusunabletosendpacketHsistatusunsuccessfultranslation Hsistatusuptinsertionfailed This page intentionally left blank HSK Device Driver Interface for VxWorks HSK Driver Object Declaration HSK Device Information Structure HSK Device Driver Interface for VxWorks HSK Driver Instantiation Code Segment Compatlistcheckdevice Redundant Host-Aware Callback Definitions Prhdeviceobj AddDevice Prhdeviceobj deviceobject Hsistatus StartDeviceHsistatus StopDevice Hsistatussuccess if successful otherwise Hsistatusfailure Hsistatus RemoveDevice Hsistatus SurpriseRemoval RH-Aware Message Registration Definitions Hsistatus rhHskRegisterMsgCallback Pcilocation pci Process Packet Callback DefinitionInt rhHskUnregisterMsgCallback UINT8* pBuf, int iLen, Pvoid pContext RH-Aware Send Message DefinitionHsistatus rhHskSendMessage Length in bytes of the data packet being sent Alternate Hscsr Interfaces PPackett RH Device Driver Interface for Linux RH Device Driver Interface for Linux Bus Mastering DMA Capable Peripheral Design Guideline for Peripheral VendorsENon Bus Mastering Peripheral Support for Unmodified Standard Drivers Design Guideline for Peripheral Vendors Porting ZT 5550 HA Applications to Picmg Category ZT 5550 Functions Redundant Host Functions Uting Porting ZT 5550 HA Applications to PicmgHAGetEthernetRo HASetEthernetRou RH Switchover on OS Crash RH Switchover on OS Crash User Documentation VxWorks Data Sheet ReferenceCompactPCI Wind River* VxWorks Programmer’s Guide is available at Data Sheet Reference Index Impi Ipmi API Page This page intentionally left blank