Method CreateRemoteConnection

Core/ClientSML/src/sml_ClientKernel.cpp:792–836

}

Kernel* Kernel::CreateRemoteConnection(bool sharedFileSystem, char const* pIPaddress, int port, bool ignoreOutput)
{
    ErrorCode errorCode = 0 ;
    
    /* -- Create Soar_Instance and Output_Manager singletons -- */
    Soar_Instance* lSoarInstance = instantiate_singletons();
    
    // Initialize the socket library before attempting to create a connection
    sock::SocketLib* pLib = new sock::SocketLib() ;
    
    // Connect to the remote socket
    Connection* pConnection = Connection::CreateRemoteConnection(sharedFileSystem, pIPaddress, port, &errorCode) ;
    
    // Even if pConnection is NULL, we still build a kernel object, so we have
    // a clean way to pass the error code back to the caller.
    Kernel* pKernel = new Kernel(pConnection) ;
    lSoarInstance->init_Soar_Instance(pKernel);
    
    pKernel->SetSocketLib(pLib) ;
    pKernel->SetError(errorCode) ;
    
    // If this client isn't interested in getting output we can speed things up a bit for them.
    pKernel->m_bIgnoreOutput = ignoreOutput ;
    
    // If we had an error creating the connection, abort before
    // we try to get the current agent list
    if (pKernel->HadError())
    {
        return pKernel ;
    }
    
    // Register for "calls" from the kernel.
    pConnection->RegisterCallback(ReceivedCall, pKernel, sml_Names::kDocType_Call, true) ;
    
    // Register for important events
    pKernel->InitEvents() ;
    
    // Initialize our time tags
    pKernel->InitializeTimeTagCounter() ;
    
    // Get the current list of active agents
    pKernel->UpdateAgentList() ;
    
    return pKernel ;
}

/*************************************************************
* @brief Returns the number of agents (from our list of known agents).