//* Copyright 2017 The NXT Authors //* //* Licensed under the Apache License, Version 2.0 (the "License"); //* you may not use this file except in compliance with the License. //* You may obtain a copy of the License at //* //* http://www.apache.org/licenses/LICENSE-2.0 //* //* Unless required by applicable law or agreed to in writing, software //* distributed under the License is distributed on an "AS IS" BASIS, //* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. //* See the License for the specific language governing permissions and //* limitations under the License. #include "wire/Wire.h" #include "wire/WireCmd.h" #include "common/Assert.h" #include #include namespace nxt { namespace wire { namespace server { class Server; struct MapReadUserdata { Server* server; uint32_t bufferId; uint32_t bufferSerial; uint32_t requestSerial; uint32_t size; }; //* Stores what the backend knows about the type. template struct ObjectDataBase { //* The backend-provided handle and serial to this object. T handle; uint32_t serial = 0; //* Built object ID and serial, needed to send to the client along with builder error callbacks //* TODO(cwallez@chromium.org) only have this for builder T uint32_t builtObjectId = 0; uint32_t builtObjectSerial = 0; //* Used by the error-propagation mechanism to know if this object is an error. //* TODO(cwallez@chromium.org): this is doubling the memory usage of //* std::vector consider making it a special marker value in handle instead. bool valid; //* Whether this object has been allocated, used by the KnownObjects queries //* TODO(cwallez@chromium.org): make this an internal bit vector in KnownObjects. bool allocated; }; //* Keeps track of the mapping between client IDs and backend objects. template class KnownObjects { public: using Data = ObjectDataBase; KnownObjects() { //* Pre-allocate ID 0 to refer to the null handle. Data nullObject; nullObject.handle = nullptr; nullObject.valid = true; nullObject.allocated = true; mKnown.push_back(nullObject); } //* Get a backend objects for a given client ID. //* Returns nullptr if the ID hasn't previously been allocated. Data* Get(uint32_t id) { if (id >= mKnown.size()) { return nullptr; } Data* data = &mKnown[id]; if (!data->allocated) { return nullptr; } return data; } //* Allocates the data for a given ID and returns it. //* Returns nullptr if the ID is already allocated, or too far ahead. //* Invalidates all the Data* Data* Allocate(uint32_t id) { if (id > mKnown.size()) { return nullptr; } Data data; data.allocated = true; data.valid = false; data.handle = nullptr; if (id >= mKnown.size()) { mKnown.push_back(data); return &mKnown.back(); } if (mKnown[id].allocated) { return nullptr; } mKnown[id] = data; return &mKnown[id]; } //* Marks an ID as deallocated void Free(uint32_t id) { ASSERT(id < mKnown.size()); mKnown[id].allocated = false; } private: std::vector mKnown; }; void ForwardDeviceErrorToServer(const char* message, nxtCallbackUserdata userdata); {% for type in by_category["object"] if type.is_builder%} void Forward{{type.name.CamelCase()}}ToClient(nxtBuilderErrorStatus status, const char* message, nxtCallbackUserdata userdata1, nxtCallbackUserdata userdata2); {% endfor %} void ForwardBufferMapReadAsync(nxtBufferMapReadStatus status, const void* ptr, nxtCallbackUserdata userdata); class Server : public CommandHandler { public: Server(nxtDevice device, const nxtProcTable& procs, CommandSerializer* serializer) : mProcs(procs), mSerializer(serializer) { //* The client-server knowledge is bootstrapped with device 1. auto* deviceData = mKnownDevice.Allocate(1); deviceData->handle = device; deviceData->valid = true; auto userdata = static_cast(reinterpret_cast(this)); procs.deviceSetErrorCallback(device, ForwardDeviceErrorToServer, userdata); } void OnDeviceError(const char* message) { ReturnDeviceErrorCallbackCmd cmd; cmd.messageStrlen = std::strlen(message); auto allocCmd = reinterpret_cast(GetCmdSpace(cmd.GetRequiredSize())); *allocCmd = cmd; strcpy(allocCmd->GetMessage(), message); } {% for type in by_category["object"] if type.is_builder%} {% set Type = type.name.CamelCase() %} void On{{Type}}Error(nxtBuilderErrorStatus status, const char* message, uint32_t id, uint32_t serial) { auto* builder = mKnown{{Type}}.Get(id); if (builder == nullptr || builder->serial != serial) { return; } if (status != NXT_BUILDER_ERROR_STATUS_SUCCESS) { builder->valid = false; } if (status != NXT_BUILDER_ERROR_STATUS_UNKNOWN) { //* Unknown is the only status that can be returned without a call to GetResult //* so we are guaranteed to have created an object. ASSERT(builder->builtObjectId != 0); Return{{Type}}ErrorCallbackCmd cmd; cmd.builtObjectId = builder->builtObjectId; cmd.builtObjectSerial = builder->builtObjectSerial; cmd.status = status; cmd.messageStrlen = std::strlen(message); auto allocCmd = reinterpret_cast(GetCmdSpace(cmd.GetRequiredSize())); *allocCmd = cmd; strcpy(allocCmd->GetMessage(), message); } } {% endfor %} void OnMapReadAsyncCallback(nxtBufferMapReadStatus status, const void* ptr, MapReadUserdata* data) { ReturnBufferMapReadAsyncCallbackCmd cmd; cmd.bufferId = data->bufferId; cmd.bufferSerial = data->bufferSerial; cmd.requestSerial = data->requestSerial; cmd.status = status; cmd.dataLength = 0; if (status == NXT_BUFFER_MAP_READ_STATUS_SUCCESS) { cmd.dataLength = data->size; } auto allocCmd = reinterpret_cast(GetCmdSpace(cmd.GetRequiredSize())); *allocCmd = cmd; if (status == NXT_BUFFER_MAP_READ_STATUS_SUCCESS) { memcpy(allocCmd->GetData(), ptr, data->size); } delete data; } const uint8_t* HandleCommands(const uint8_t* commands, size_t size) override { mProcs.deviceTick(mKnownDevice.Get(1)->handle); while (size > sizeof(WireCmd)) { WireCmd cmdId = *reinterpret_cast(commands); bool success = false; switch (cmdId) { {% for type in by_category["object"] %} {% for method in type.methods %} {% set Suffix = as_MethodSuffix(type.name, method.name) %} case WireCmd::{{Suffix}}: success = Handle{{Suffix}}(&commands, &size); break; {% endfor %} {% set Suffix = as_MethodSuffix(type.name, Name("destroy")) %} case WireCmd::{{Suffix}}: success = Handle{{Suffix}}(&commands, &size); break; {% endfor %} case WireCmd::BufferMapReadAsync: success = HandleBufferMapReadAsync(&commands, &size); break; default: success = false; } if (!success) { return nullptr; } } if (size != 0) { return nullptr; } return commands; } private: nxtProcTable mProcs; CommandSerializer* mSerializer = nullptr; void* GetCmdSpace(size_t size) { return mSerializer->GetCmdSpace(size); } //* The list of known IDs for each object type. {% for type in by_category["object"] %} KnownObjects<{{as_cType(type.name)}}> mKnown{{type.name.CamelCase()}}; {% endfor %} //* Helper function for the getting of the command data in command handlers. //* Checks there is enough data left, updates the buffer / size and returns //* the command (or nullptr for an error). template static const T* GetCommand(const uint8_t** commands, size_t* size) { if (*size < sizeof(T)) { return nullptr; } const T* cmd = reinterpret_cast(*commands); size_t cmdSize = cmd->GetRequiredSize(); if (*size < cmdSize) { return nullptr; } *commands += cmdSize; *size -= cmdSize; return cmd; } //* Implementation of the command handlers {% for type in by_category["object"] %} {% for method in type.methods %} {% set Suffix = as_MethodSuffix(type.name, method.name) %} //* The generic command handlers bool Handle{{Suffix}}(const uint8_t** commands, size_t* size) { //* Get command ptr, and check it fits in the buffer. const auto* cmd = GetCommand<{{Suffix}}Cmd>(commands, size); if (cmd == nullptr) { return false; } //* While unpacking arguments, if any of them is an error, valid will be set to false. bool valid = true; //* Unpack 'self' {% set Type = type.name.CamelCase() %} {{as_cType(type.name)}} self; auto* selfData = mKnown{{Type}}.Get(cmd->self); { if (selfData == nullptr) { return false; } valid = valid && selfData->valid; self = selfData->handle; } //* Unpack value objects from IDs. {% for arg in method.arguments if arg.annotation == "value" and arg.type.category == "object" %} {% set Type = arg.type.name.CamelCase() %} {{as_cType(arg.type.name)}} arg_{{as_varName(arg.name)}}; { auto* data = mKnown{{Type}}.Get(cmd->{{as_varName(arg.name)}}); if (data == nullptr) { return false; } valid = valid && data->valid; arg_{{as_varName(arg.name)}} = data->handle; } {% endfor %} //* Unpack pointer arguments {% for arg in method.arguments if arg.annotation != "value" %} {% set argName = as_varName(arg.name) %} const {{as_cType(arg.type.name)}}* arg_{{argName}}; {% if arg.length == "strlen" %} //* Unpack strings, checking they are null-terminated. arg_{{argName}} = reinterpret_cast(cmd->GetPtr_{{argName}}()); if (arg_{{argName}}[cmd->{{argName}}Strlen] != 0) { return false; } {% elif arg.type.category == "object" %} //* Unpack arrays of objects. //* TODO(cwallez@chromium.org) do not allocate when there are few objects. std::vector<{{as_cType(arg.type.name)}}> {{argName}}Storage(cmd->{{as_varName(arg.length.name)}}); auto {{argName}}Ids = reinterpret_cast(cmd->GetPtr_{{argName}}()); for (size_t i = 0; i < cmd->{{as_varName(arg.length.name)}}; i++) { {% set Type = arg.type.name.CamelCase() %} auto* data = mKnown{{Type}}.Get({{argName}}Ids[i]); if (data == nullptr) { return false; } {{argName}}Storage[i] = data->handle; valid = valid && data->valid; } arg_{{argName}} = {{argName}}Storage.data(); {% else %} //* For anything else, just get the pointer. arg_{{argName}} = reinterpret_cast(cmd->GetPtr_{{argName}}()); {% endif %} {% endfor %} //* At that point all the data has been upacked in cmd->* or arg_* //* In all cases allocate the object data as it will be refered-to by the client. {% set return_type = method.return_type %} {% set returns = return_type.name.canonical_case() != "void" %} {% if returns %} {% set Type = method.return_type.name.CamelCase() %} auto* resultData = mKnown{{Type}}.Allocate(cmd->resultId); if (resultData == nullptr) { return false; } resultData->serial = cmd->resultSerial; {% if type.is_builder %} selfData->builtObjectId = cmd->resultId; selfData->builtObjectSerial = cmd->resultSerial; {% endif %} {% endif %} //* After the data is allocated, apply the argument error propagation mechanism if (!valid) { {% if type.is_builder %} selfData->valid = false; //* If we are in GetResult, fake an error callback {% if returns %} On{{type.name.CamelCase()}}Error(NXT_BUILDER_ERROR_STATUS_ERROR, "Maybe monad", cmd->self, selfData->serial); {% endif %} {% endif %} return true; } {% if returns %} auto result ={{" "}} {%- endif %} mProcs.{{as_varName(type.name, method.name)}}(self {%- for arg in method.arguments -%} {%- if arg.annotation == "value" and arg.type.category != "object" -%} , cmd->{{as_varName(arg.name)}} {%- else -%} , arg_{{as_varName(arg.name)}} {%- endif -%} {%- endfor -%} ); {% if returns %} resultData->handle = result; resultData->valid = result != nullptr; //* builders remember the ID of the object they built so that they can send it //* in the callback to the client. {% if return_type.is_builder %} if (result != nullptr) { uint64_t userdata1 = static_cast(reinterpret_cast(this)); uint64_t userdata2 = (uint64_t(resultData->serial) << uint64_t(32)) + cmd->resultId; mProcs.{{as_varName(return_type.name, Name("set error callback"))}}(result, Forward{{return_type.name.CamelCase()}}ToClient, userdata1, userdata2); } {% endif %} {% endif %} return true; } {% endfor %} //* Handlers for the destruction of objects: clients do the tracking of the //* reference / release and only send destroy on refcount = 0. {% set Suffix = as_MethodSuffix(type.name, Name("destroy")) %} bool Handle{{Suffix}}(const uint8_t** commands, size_t* size) { const auto* cmd = GetCommand<{{Suffix}}Cmd>(commands, size); if (cmd == nullptr) { return false; } //* ID 0 are reserved for nullptr and cannot be destroyed. if (cmd->objectId == 0) { return false; } auto* data = mKnown{{type.name.CamelCase()}}.Get(cmd->objectId); if (data == nullptr) { return false; } if (data->valid) { mProcs.{{as_varName(type.name, Name("release"))}}(data->handle); } mKnown{{type.name.CamelCase()}}.Free(cmd->objectId); return true; } {% endfor %} bool HandleBufferMapReadAsync(const uint8_t** commands, size_t* size) { //* These requests are just forwarded to the buffer, with userdata containing what the client //* will require in the return command. const auto* cmd = GetCommand(commands, size); if (cmd == nullptr) { return false; } auto* buffer = mKnownBuffer.Get(cmd->bufferId); if (buffer == nullptr) { return false; } auto* data = new MapReadUserdata; data->server = this; data->bufferId = cmd->bufferId; data->bufferSerial = buffer->serial; data->requestSerial = cmd->requestSerial; data->size = cmd->size; auto userdata = static_cast(reinterpret_cast(data)); if (!buffer->valid) { //* Fake the buffer returning a failure, data will be freed in this call. ForwardBufferMapReadAsync(NXT_BUFFER_MAP_READ_STATUS_ERROR, nullptr, userdata); return true; } mProcs.bufferMapReadAsync(buffer->handle, cmd->start, cmd->size, ForwardBufferMapReadAsync, userdata); return true; } }; void ForwardDeviceErrorToServer(const char* message, nxtCallbackUserdata userdata) { auto server = reinterpret_cast(static_cast(userdata)); server->OnDeviceError(message); } {% for type in by_category["object"] if type.is_builder%} void Forward{{type.name.CamelCase()}}ToClient(nxtBuilderErrorStatus status, const char* message, nxtCallbackUserdata userdata1, nxtCallbackUserdata userdata2) { auto server = reinterpret_cast(static_cast(userdata1)); uint32_t id = userdata2 & 0xFFFFFFFFu; uint32_t serial = userdata2 >> uint64_t(32); server->On{{type.name.CamelCase()}}Error(status, message, id, serial); } {% endfor %} void ForwardBufferMapReadAsync(nxtBufferMapReadStatus status, const void* ptr, nxtCallbackUserdata userdata) { auto data = reinterpret_cast(static_cast(userdata)); data->server->OnMapReadAsyncCallback(status, ptr, data); } } CommandHandler* NewServerCommandHandler(nxtDevice device, const nxtProcTable& procs, CommandSerializer* serializer) { return new server::Server(device, procs, serializer); } } }