alf_init - Initializes the ALF runtime.
int alf_init(void* p_sys_config_info, alf_handle_t* p_alf_handle);
| Parameters | |
| p_sys_config_info [IN] | A platform-dependent configuration information placeholder
so that the ALF runtime can get the necessary data for system
configuration information. This parameter should point
to an alf_sys_config_t_Hybrid_t data structure. This data
structure is defined as followed;
typedef struct {
char* library_path;
unsigned int num_of_ppes;
char* ppe_image_path;
char* ppe_image_name;
char* ppe_image_mode;
} alf_sys_config_t_Hybrid;
|
| p_alf_handle [OUT] | A pointer to a handle for a data structure that represents the ALF runtime. This buffer is initialized with proper data if the call is successful. Otherwise, the content is not modified. |
This function initializes the ALF runtime. It allocates the necessary resources and global data for ALF as well as sets up any platform specific configurations.
| >= 0 | Successful, the result of the query |
| less than 0 | Errors:
|
| Field value | |
| library_path | The path to all of the application's computational kernel shared object files. If the pointer is NULL, the ALF_LIBRARY_PATH environment variable is checked and if it is defined then it is used. If neither is set, the default "." is used. |
| num_of_ppes | The number of PPEs to use for application execution. If the value is 0, the ALF_NUM_OF_PPES environment variable is checked and if it is defined then it is used. If neither is set, the default 0 (use all available PPEs) is used. |
| ppe_image_path | Depending upon the ppe_image_mode (see below), it is either the remote path to the application's PPE daemon or the local path to the application's file list which are to be transferred to the PPE and the first executed. If the pointer is NULL, the ALF_PPE_IMAGE_PATH environment variable is checked and if it is defined then it is used. If neither is set, the default "/opt/cell/sdk/prototype/usr/bin" is used. |
| ppe_image_name | Depending upon the ppe_image_mode (see below), it is either the name of the application's PPE daemon, or the name of the application's file list. If the pointer is NULL, the ALF_PPE_IMAGE_NAME environment variable is checked and if it is defined then it is used. If neither is set, the default "alf_hybrid_d_ppu64" is used. |
| ppe_image_mode | The mode to interpret the ppe_image_path and ppe_image_name (see above). It is either the case-insensitive string "remote" or "filelist". If the pointer is NULL, the ALF_PPE_IMAGE_MODE environment variable is checked and if it is defined then it is used. If neither is set, the default "remote" is used. |