/* * All or portions of this file Copyright (c) Amazon.com, Inc. or its affiliates or * its licensors. * * For complete copyright and license terms please see the LICENSE at the root of this * distribution (the "License"). All use of this software is governed by the License, * or, if provided, by the license below or the license accompanying this file. Do not * remove or modify any license notices. This file is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * */ #include #include #include #include #include "RemoteConsoleCore.h" #include const int defaultRemoteConsolePort = 4600; // externed in the header to expose publicly namespace { static const int kDefaultBufferSize = 4096; static const AZ::u16 kMaxBindPorts = 8; // max range of ports to bind to for remote console static const char* kServerThreadName = "RemoteConsoleServer"; static const char* kClientThreadName = "RemoteConsoleClient"; } bool RCON_IsRemoteAllowedToConnect(const AZ::AzSock::AzSocketAddress& connectee) { if ((!gEnv) || (!gEnv->pConsole)) { CryLog("Cannot allow incoming connection for remote console, because we do not yet have a console or an environment."); return false; } ICVar* remoteConsoleAllowedHostList = gEnv->pConsole->GetCVar("log_RemoteConsoleAllowedAddresses"); if (!remoteConsoleAllowedHostList) { CryLog("Cannot allow incoming connection for remote console, because there is no registered log_RemoteConsoleAllowedAddresses console variable."); return false; } const char* value = remoteConsoleAllowedHostList->GetString(); // the default or empty string indicates localhost. if (!value) { value = ""; } AZStd::vector addresses; AzFramework::StringFunc::Tokenize(value, addresses, ','); if (addresses.empty()) { addresses.push_back("127.0.0.1"); } AZ::AzSock::AzSocketAddress testAddress; for (const AZStd::string& address : addresses) { // test the whitelisted addresses with connectee's port to see if we have a match testAddress.SetAddress(address.c_str(), connectee.GetAddrPort()); if (testAddress == connectee) { // its an exact match. if (gEnv->pLog) { gEnv->pLog->LogToConsole("Remote console connected from ip %s (matches: %s)", connectee.GetAddress().c_str(), address.c_str()); } return true; } } if (gEnv->pLog) { gEnv->pLog->LogToConsole("An attempt to connect to remote console from ip %s failed because it is not on the whitelist.", connectee.GetAddress().c_str()); gEnv->pLog->LogToConsole("Add to the whitelist using the CVAR log_RemoteConsoleAllowedAddresses (comma separated IPs or hostnames)"); gEnv->pLog->LogToConsole("Example: log_RemoteConsoleAllowedAddresses localhost,joescomputer"); } return false; // return false by default, so you MUST pass an above check for you to be allowed in. } ///////////////////////////////////////////////////////////////////////////////////////////// ///////////////////////////////////////////////////////////////////////////////////////////// ///////////////////////////////////////////////////////////////////////////////////////////// void SRemoteServer::StartServer() { StopServer(); m_bAcceptClients = true; Start(0, kServerThreadName); } ///////////////////////////////////////////////////////////////////////////////////////////// void SRemoteServer::StopServer() { Stop(); m_bAcceptClients = false; AZ::AzSock::CloseSocket(m_socket); m_socket = SOCKET_ERROR; m_lock.Lock(); for (TClients::iterator it = m_clients.begin(); it != m_clients.end(); ++it) { it->pClient->StopClient(); } m_lock.Unlock(); m_stopEvent.Wait(); m_stopEvent.Set(); } ///////////////////////////////////////////////////////////////////////////////////////////// void SRemoteServer::ClientDone(SRemoteClient* pClient) { m_lock.Lock(); for (TClients::iterator it = m_clients.begin(); it != m_clients.end(); ++it) { if (it->pClient == pClient) { it->pClient->Stop(); delete it->pClient; delete it->pEvents; m_clients.erase(it); break; } } if (m_clients.empty()) { m_stopEvent.Set(); } m_lock.Unlock(); } ///////////////////////////////////////////////////////////////////////////////////////////// void SRemoteServer::Terminate() { } ///////////////////////////////////////////////////////////////////////////////////////////// void SRemoteServer::Run() { SetName(kServerThreadName); AZ_TRAIT_REMOTECONSOLE_SET_THREAD_AFFINITY AZSOCKET sClient; AZ::AzSock::AzSocketAddress local; int result = 0; if (AZ::AzSock::SocketErrorOccured(AZ::AzSock::Startup())) { gEnv->pLog->LogError("[RemoteKeyboard] Failed to load Winsock!\n"); return; } m_socket = AZ::AzSock::Socket(); if (!AZ::AzSock::IsAzSocketValid(m_socket)) { CryLog("Remote console FAILED. socket() => SOCKET_ERROR"); return; } // this CVAR is optional. AZ::u16 remotePort = defaultRemoteConsolePort; ICVar* remoteConsolePort = gEnv->pConsole->GetCVar("log_RemoteConsolePort"); if (remoteConsolePort) { remotePort = static_cast(remoteConsolePort->GetIVal()); } // // There may be multiple processes running, and each process will require a unique port for remote console to work. // So we need to be able to bind to ascending ports so that automated tests can connect to each process. QA's Automated // tools depend on this behavior for successful testing to occur. // Please check with ly-networking, ly-systems or ly-qa before changing this. // Thanks. // bool bindOk = false; for (AZ::u16 port=remotePort; port < (remotePort + kMaxBindPorts); port++) { local.SetAddrPort(port); result = AZ::AzSock::Bind(m_socket, local); if (!AZ::AzSock::SocketErrorOccured(result)) { bindOk = true; break; } } if ( !bindOk ) { CryLog("Failed to bind Remote Console to ports %hu to %hu", remotePort, static_cast(remotePort + kMaxBindPorts - 1) ); return; } AZ::AzSock::Listen(m_socket, 8); AZ::AzSock::AzSocketAddress sockName; result = AZ::AzSock::GetSockName(m_socket, sockName); if (!AZ::AzSock::SocketErrorOccured(result)) { CryLog("Remote console listening on: %d\n", sockName.GetAddrPort()); } else { CryLog("Remote console FAILED to listen on: %d\n", sockName.GetAddrPort()); } while (m_bAcceptClients) { AZ::AzSock::AzSocketAddress clientAddress; sClient = AZ::AzSock::Accept(m_socket, clientAddress); if (!m_bAcceptClients || !AZ::AzSock::IsAzSocketValid(sClient)) { break; } if (!RCON_IsRemoteAllowedToConnect(clientAddress)) { AZ::AzSock::CloseSocket(sClient); continue; } m_lock.Lock(); m_stopEvent.Reset(); SRemoteClient* pClient = new SRemoteClient(this); m_clients.push_back(SRemoteClientInfo(pClient)); pClient->StartClient(sClient); m_lock.Unlock(); } AZ::AzSock::CloseSocket(m_socket); CryLog("Remote console terminating.\n"); //AZ::AzSock::Shutdown(); } ///////////////////////////////////////////////////////////////////////////////////////////// void SRemoteServer::AddEvent(IRemoteEvent* pEvent) { m_lock.Lock(); for (TClients::iterator it = m_clients.begin(); it != m_clients.end(); ++it) { it->pEvents->push_back(pEvent->Clone()); } m_lock.Unlock(); delete pEvent; } ///////////////////////////////////////////////////////////////////////////////////////////// void SRemoteServer::GetEvents(TEventBuffer& buffer) { m_lock.Lock(); buffer = m_eventBuffer; m_eventBuffer.clear(); m_lock.Unlock(); } ///////////////////////////////////////////////////////////////////////////////////////////// bool SRemoteServer::WriteBuffer(SRemoteClient* pClient, char* buffer, int& size) { m_lock.Lock(); IRemoteEvent* pEvent = nullptr; for (TClients::iterator it = m_clients.begin(); it != m_clients.end(); ++it) { if (it->pClient == pClient) { TEventBuffer* pEvents = it->pEvents; if (!pEvents->empty()) { pEvent = pEvents->front(); pEvents->pop_front(); } break; } } m_lock.Unlock(); const bool res = (pEvent != nullptr); if (pEvent) { SRemoteEventFactory::GetInst()->WriteToBuffer(pEvent, buffer, size, kDefaultBufferSize); delete pEvent; } return res; } ///////////////////////////////////////////////////////////////////////////////////////////// bool SRemoteServer::ReadBuffer(const char* buffer, int data) { bool result = true; // Sometimes multiple events can come in a single buffer, so make sure we look // at the entire thing. int bytesRemaining = data; const char* curBuffer = buffer; while (bytesRemaining > 0) { // Create the event from the current sub string in the buffer. IRemoteEvent* event = SRemoteEventFactory::GetInst()->CreateEventFromBuffer(curBuffer, bytesRemaining); result &= (event != nullptr); if (event) { if (event->GetType() != eCET_Noop) { m_lock.Lock(); m_eventBuffer.push_back(event); m_lock.Unlock(); } else { delete event; } } // Advance to the next null terminated string in the buffer const int currentSize = strnlen(curBuffer, bytesRemaining); bytesRemaining -= currentSize + 1; curBuffer += currentSize + 1; } return result; } ///////////////////////////////////////////////////////////////////////////////////////////// ///////////////////////////////////////////////////////////////////////////////////////////// ///////////////////////////////////////////////////////////////////////////////////////////// void SRemoteClient::StartClient(AZSOCKET socket) { m_socket = socket; Start(0, kClientThreadName); } ///////////////////////////////////////////////////////////////////////////////////////////// void SRemoteClient::StopClient() { AZ::AzSock::CloseSocket(m_socket); m_socket = AZ_SOCKET_INVALID; } ///////////////////////////////////////////////////////////////////////////////////////////// void SRemoteClient::Terminate() { m_pServer->ClientDone(this); } ///////////////////////////////////////////////////////////////////////////////////////////// void SRemoteClient::Run() { SetName(kClientThreadName); AZ_TRAIT_REMOTECONSOLE_SET_THREAD_AFFINITY char szBuff[kDefaultBufferSize]; int size; SNoDataEvent reqEvt; AZStd::vector autoCompleteList; FillAutoCompleteList(autoCompleteList); bool ok = true; bool autoCompleteDoneSent = false; while (ok) { // read data SRemoteEventFactory::GetInst()->WriteToBuffer(&reqEvt, szBuff, size, kDefaultBufferSize); ok &= SendPackage(szBuff, size); ok &= RecvPackage(szBuff, size); ok &= m_pServer->ReadBuffer(szBuff, size); for (int i = 0; i < 20 && !autoCompleteList.empty(); ++i) { SStringEvent autoCompleteListEvt(autoCompleteList.back().c_str()); SRemoteEventFactory::GetInst()->WriteToBuffer(&autoCompleteListEvt, szBuff, size, kDefaultBufferSize); ok &= SendPackage(szBuff, size); ok &= RecvPackage(szBuff, size); ok &= m_pServer->ReadBuffer(szBuff, size); autoCompleteList.pop_back(); } if (autoCompleteList.empty() && !autoCompleteDoneSent) { SNoDataEvent autoCompleteDone; SRemoteEventFactory::GetInst()->WriteToBuffer(&autoCompleteDone, szBuff, size, kDefaultBufferSize); ok &= SendPackage(szBuff, size); ok &= RecvPackage(szBuff, size); ok &= m_pServer->ReadBuffer(szBuff, size); autoCompleteDoneSent = true; } // send data while (ok && m_pServer->WriteBuffer(this, szBuff, size)) { ok &= SendPackage(szBuff, size); ok &= RecvPackage(szBuff, size); ok &= m_pServer->ReadBuffer(szBuff, size); } } } ///////////////////////////////////////////////////////////////////////////////////////////// bool SRemoteClient::RecvPackage(char* buffer, int& size) { size = 0; int ret, idx = 0; do { ret = AZ::AzSock::Recv(m_socket, buffer + idx, kDefaultBufferSize - idx, 0); if (AZ::AzSock::SocketErrorOccured(ret)) { return false; } idx += ret; } while (buffer[idx - 1] != '\0'); size = idx; return true; } ///////////////////////////////////////////////////////////////////////////////////////////// bool SRemoteClient::SendPackage(const char* buffer, int size) { int ret, idx = 0; int left = size + 1; assert(buffer[size] == '\0'); while (left > 0) { ret = AZ::AzSock::Send(m_socket, &buffer[idx], left, 0); if (AZ::AzSock::SocketErrorOccured(ret)) { return false; } left -= ret; idx += ret; } return true; } ///////////////////////////////////////////////////////////////////////////////////////////// void SRemoteClient::FillAutoCompleteList(AZStd::vector& list) { AZStd::vector cmds; size_t count = gEnv->pConsole->GetSortedVars(nullptr, 0); cmds.resize(count); count = gEnv->pConsole->GetSortedVars(&cmds[0], count); for (size_t i = 0; i < count; ++i) { list.push_back(cmds[i]); } if (!gEnv->pSystem || !gEnv->pSystem->GetILevelSystem()) { return; } for (int i = 0, end = gEnv->pSystem->GetILevelSystem()->GetLevelCount(); i < end; ++i) { ILevelInfo* pLevel = gEnv->pSystem->GetILevelSystem()->GetLevelInfo(i); AZStd::string item = "map "; const char* levelName = pLevel->GetName(); int start = 0; for (int k = 0, kend = strlen(levelName); k < kend; ++k) { if ((levelName[k] == '\\' || levelName[k] == '/') && k + 1 < kend) { start = k + 1; } } item += levelName + start; list.push_back(item); } } ///////////////////////////////////////////////////////////////////////////////////////////// /////////////////////////////////// Event factory /////////////////////////////////////////// ///////////////////////////////////////////////////////////////////////////////////////////// #define REGISTER_EVENT_NODATA(evt) RegisterEvent(new SNoDataEvent()); #define REGISTER_EVENT_STRING(evt) RegisterEvent(new SStringEvent("")); ///////////////////////////////////////////////////////////////////////////////////////////// SRemoteEventFactory::SRemoteEventFactory() { REGISTER_EVENT_NODATA(eCET_Noop); REGISTER_EVENT_NODATA(eCET_Req); REGISTER_EVENT_STRING(eCET_LogMessage); REGISTER_EVENT_STRING(eCET_LogWarning); REGISTER_EVENT_STRING(eCET_LogError); REGISTER_EVENT_STRING(eCET_ConsoleCommand); REGISTER_EVENT_STRING(eCET_AutoCompleteList); REGISTER_EVENT_NODATA(eCET_AutoCompleteListDone); REGISTER_EVENT_NODATA(eCET_Strobo_GetThreads); REGISTER_EVENT_STRING(eCET_Strobo_ThreadAdd); REGISTER_EVENT_NODATA(eCET_Strobo_ThreadDone); REGISTER_EVENT_NODATA(eCET_Strobo_GetResult); REGISTER_EVENT_NODATA(eCET_Strobo_ResultStart); REGISTER_EVENT_NODATA(eCET_Strobo_ResultDone); REGISTER_EVENT_NODATA(eCET_Strobo_StatStart); REGISTER_EVENT_STRING(eCET_Strobo_StatAdd); REGISTER_EVENT_NODATA(eCET_Strobo_ThreadInfoStart); REGISTER_EVENT_STRING(eCET_Strobo_ThreadInfoAdd); REGISTER_EVENT_NODATA(eCET_Strobo_SymStart); REGISTER_EVENT_STRING(eCET_Strobo_SymAdd); REGISTER_EVENT_NODATA(eCET_Strobo_CallstackStart); REGISTER_EVENT_STRING(eCET_Strobo_CallstackAdd); REGISTER_EVENT_STRING(eCET_GameplayEvent); REGISTER_EVENT_NODATA(eCET_Strobo_FrameInfoStart); REGISTER_EVENT_STRING(eCET_Strobo_FrameInfoAdd); } ///////////////////////////////////////////////////////////////////////////////////////////// SRemoteEventFactory::~SRemoteEventFactory() { for (TPrototypes::iterator it = m_prototypes.begin(), end = m_prototypes.end(); it != end; ++it) { delete it->second; } } ///////////////////////////////////////////////////////////////////////////////////////////// IRemoteEvent* SRemoteEventFactory::CreateEventFromBuffer(const char* buffer, int size) { if (size > 1 && buffer[size - 1] == '\0') { EConsoleEventType type = EConsoleEventType(buffer[0] - '0'); TPrototypes::const_iterator it = m_prototypes.find(type); if (it != m_prototypes.end()) { IRemoteEvent* pEvent = it->second->CreateFromBuffer(buffer + 1, size - 1); return pEvent; } } return nullptr; } ///////////////////////////////////////////////////////////////////////////////////////////// void SRemoteEventFactory::WriteToBuffer(IRemoteEvent* pEvent, char* buffer, int& size, int maxsize) { assert(m_prototypes.find(pEvent->GetType()) != m_prototypes.end()); buffer[0] = '0' + (char)pEvent->GetType(); pEvent->WriteToBuffer(buffer + 1, size, maxsize - 2); buffer[++size] = '\0'; } ///////////////////////////////////////////////////////////////////////////////////////////// void SRemoteEventFactory::RegisterEvent(IRemoteEvent* pEvent) { assert(m_prototypes.find(pEvent->GetType()) == m_prototypes.end()); m_prototypes[pEvent->GetType()] = pEvent; }