man pages section 3: Extended Library Functions, Volume 2

IMA_PhbaDownload (3IMA)

Name

IMA_PhbaDownload - Downloads the image in a specified file to a specified PHBA

Synopsis

cc [ flag... ] file... -lima [ library... ]
#include <ima.h>

IMA_STATUS IMA_PhbaDownload(
     /* in */     IMA_OID phbaOid,
     /* in */     IMA_PHBA_DOWNLOAD_IMAGE_TYPE imageType,
     /* in */     const IMA_WCHAR *pFileName
);

Parameters

phbaOid

The object ID of the PHBA (physical host bus adapter) to which the image file is downloaded

imageType

The type of image downloaded

pFileName

A pointer to the name, and if necessary the path, of a file that contains the image to download to the PHBA

Description

The IMA_PhbaDownload() API downloads the image in a specified file to a specified PHBA.

Return Values

IMA_ERROR_NOT_SUPPORTED

Returned if this API is not supported by the specified PHBA

IMA_ERROR_INVALID_PARAMETER

• Returned if the imageType argument does not specify a valid IMA_PHBA_DOWNLOAD_IMAGE_TYPE value

• Returned if the pFileName argument is NULL, or specifies a memory area from which data cannot be read

• Returned if the pFileName argument specifies a file that cannot be opened for reading or that does not contain a download image of the specified image type

IMA_ERROR_INVALID_OBJECT_TYPE

Returned if the phbaOid argument does not specify a valid object type

IMA_ERROR_INCORRECT_OBJECT_TYPE

Returned if the phbaOid argument does not specify a PHBA object

IMA_ERROR_OBJECT_NOT_FOUND

Returned if the phbaOid argument does not specify a PHBA known to the system

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE Availability system/library/storage/snia-ima Interface Stability Volatile MT-Level Safe

See Also

libima(3LIB), attributes(7), IMA_GetPhbaDownloadProperties(3IMA), IMA_IsPhbaDownloadFile(3IMA)