lgo_ConfigureStack()

Load a default stack configuration from file.

#include "laygo.h"

LResult lgo_ConfigureStack
    (
        LFileName    fileName
    );

lgo_ConfigureStack() loads default configuration profiles from a file prior to stack initialization. This function can be called repeatedly to load parts of an overall configuration from different files. Configuration data from files loaded later will overwrite information read from earlier files if they contain overlapping sections. Configurations for the SDLC hardware, system buffer pool and the protocol stack cannot be changed after the stack is initialized. Configurations for individual protocol services can be changed using lgo_SetConfiguration().

lgo_ConfigureStack() is an invalid command after the stack has been initialized.

If successful, lgo_ConfigureStack() returns a non-negative value. Otherwise, it returns a negative value indicating the reason it failed. Possible unsuccessful return values are:

• lgo_ERROR_INVALID_COMMAND
• lgo_ERROR_CONFIGURATION_FILE_NOT_FOUND
• lgo_ERROR_CONFIGURATION_FILE_READ_ERROR
• lgo_ERROR_OUT_OF_MEMORY

lgo_InitializeStack()
lgo_SetConfiguration()

LResult    result;

result = lgo_ConfigureStack("laygo.cfg");

if (result < 0)
{
    return (FAILURE);
}