fsp_plms_GetDependencyTree()

Synopsis:

#include <fsp/plms.h>

fsp_ResultType fsp_plms_GetDependencyTree( fsp_plms_HandleType *plms_hdl,
                                           char* file_name );

Arguments:

plms_hdl

The plms_hdl returned in fsp_plms_Connect().

file_name

The name of the file to log the dependency tree.

Library:

libplms

Use the -l plms option to qcc to link against this library.

Description

The fsp_plms_GetDependencyTree() function logs the current dependency tree that is processed by PLMS. The fsp_plms_GetDependencyTree() call is an asynchronous call. Only one dependency logging is allowed at a time. If a dependency tree logging is already in progress, PLMS returns an error. PLMS writes 0x0000000000 as a magic number in the first four bytes of the file to indicate that the DAG printing operation is in progress and 0xFFFFFFFF when the printing operation is completed. The caller must have the plms/query ability set to use this call.

Returns

Returns FSP_PLMS_STATUS_EOK on success, or FSP_PLMS_STATUS_FAIL on error and sets errno.

Example

fsp_plms_GetDependencyTree(plms_hdl, “/dev/shmem/plms_dag1”);