ddsGetLibManLogFileName

ddsGetLibManLogFileName(
[g_query]
) 
=> t_logPath / l_dpl / nil

Description

Returns the path to the log file created by Library Manager.

Arguments

g_query

Specifies the query for the current or previous log file path created by Library Manager. When query is nil or a string, or if no argument was specified, then the SKILL API returns a string for the log file path, or nil for no file. When query is a Disembodied property list, a new DPL is returned containing multiple values.

Values Returned

t_logPath	The path to the log file created by Library Manager.
l_dpl	Disembodied property list containing recognized property names from query DPL. Returns the following values: log: Returns nil or the string for the path to the log file. pid: Returns nil or the integer process ID of the active Library Manager. logPid: Returns nil or the integer process ID of the Library Manager used to create the log file.
nil	No log file exists.

Examples

The following examples show queries for the path of the current or previous Library Manager log file.

ddsGetLibManLogFileName()

=>nil

ddsGetLibManLogFileName( nil )

=>nil

ddsGetLibManLogFileName( "string" )

=>nil

This following example shows query with DPL input to consider only an active Library Manager log file

detailsDpl = ddsGetLibManLogFileName( '( myTag log nil pid nil logPid nil ) )

when( pairp( detailsDpl) 

    when( fixp( detailsDpl->pid ) && stringp( detailsDpl->log ) &&

           detailsDpl->pid == detailsDpl->logPid

        printf("Library Manager is running with log file %s\n" detailsDpl->log)

))

Return to top