diff options
Diffstat (limited to 'src/spdk/lib/jsonrpc/jsonrpc_server.c')
-rw-r--r-- | src/spdk/lib/jsonrpc/jsonrpc_server.c | 360 |
1 files changed, 360 insertions, 0 deletions
diff --git a/src/spdk/lib/jsonrpc/jsonrpc_server.c b/src/spdk/lib/jsonrpc/jsonrpc_server.c new file mode 100644 index 00000000..6e2a5b2c --- /dev/null +++ b/src/spdk/lib/jsonrpc/jsonrpc_server.c @@ -0,0 +1,360 @@ +/*- + * BSD LICENSE + * + * Copyright (c) Intel Corporation. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * * Neither the name of Intel Corporation nor the names of its + * contributors may be used to endorse or promote products derived + * from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR + * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT + * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, + * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT + * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE + * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +#include "jsonrpc_internal.h" + +#include "spdk/util.h" + +struct jsonrpc_request { + const struct spdk_json_val *version; + const struct spdk_json_val *method; + const struct spdk_json_val *params; + const struct spdk_json_val *id; +}; + +static int +capture_val(const struct spdk_json_val *val, void *out) +{ + const struct spdk_json_val **vptr = out; + + *vptr = val; + return 0; +} + +static const struct spdk_json_object_decoder jsonrpc_request_decoders[] = { + {"jsonrpc", offsetof(struct jsonrpc_request, version), capture_val, true}, + {"method", offsetof(struct jsonrpc_request, method), capture_val}, + {"params", offsetof(struct jsonrpc_request, params), capture_val, true}, + {"id", offsetof(struct jsonrpc_request, id), capture_val, true}, +}; + +static void +parse_single_request(struct spdk_jsonrpc_request *request, struct spdk_json_val *values) +{ + bool invalid = false; + struct jsonrpc_request req = {}; + + if (spdk_json_decode_object(values, jsonrpc_request_decoders, + SPDK_COUNTOF(jsonrpc_request_decoders), + &req)) { + invalid = true; + goto done; + } + + if (req.version && (req.version->type != SPDK_JSON_VAL_STRING || + !spdk_json_strequal(req.version, "2.0"))) { + invalid = true; + } + + if (!req.method || req.method->type != SPDK_JSON_VAL_STRING) { + req.method = NULL; + invalid = true; + } + + if (req.id) { + if (req.id->type == SPDK_JSON_VAL_STRING || + req.id->type == SPDK_JSON_VAL_NUMBER) { + /* Copy value into request */ + if (req.id->len <= SPDK_JSONRPC_ID_MAX_LEN) { + request->id.type = req.id->type; + request->id.len = req.id->len; + memcpy(request->id.start, req.id->start, req.id->len); + } else { + SPDK_DEBUGLOG(SPDK_LOG_RPC, "JSON-RPC request id too long (%u)\n", + req.id->len); + invalid = true; + } + } else if (req.id->type == SPDK_JSON_VAL_NULL) { + request->id.type = SPDK_JSON_VAL_NULL; + } else { + invalid = true; + } + } + + if (req.params) { + if (req.params->type != SPDK_JSON_VAL_ARRAY_BEGIN && + req.params->type != SPDK_JSON_VAL_OBJECT_BEGIN) { + req.params = NULL; + invalid = true; + } + } + +done: + if (invalid) { + spdk_jsonrpc_server_handle_error(request, SPDK_JSONRPC_ERROR_INVALID_REQUEST); + } else { + spdk_jsonrpc_server_handle_request(request, req.method, req.params); + } +} + +int +spdk_jsonrpc_parse_request(struct spdk_jsonrpc_server_conn *conn, void *json, size_t size) +{ + struct spdk_jsonrpc_request *request; + ssize_t rc; + void *end = NULL; + + /* Check to see if we have received a full JSON value. */ + rc = spdk_json_parse(json, size, NULL, 0, &end, 0); + if (rc == SPDK_JSON_PARSE_INCOMPLETE) { + return 0; + } + + request = calloc(1, sizeof(*request)); + if (request == NULL) { + SPDK_DEBUGLOG(SPDK_LOG_RPC, "Out of memory allocating request\n"); + return -1; + } + + conn->outstanding_requests++; + + request->conn = conn; + request->id.start = request->id_data; + request->id.len = 0; + request->id.type = SPDK_JSON_VAL_INVALID; + request->send_offset = 0; + request->send_len = 0; + request->send_buf_size = SPDK_JSONRPC_SEND_BUF_SIZE_INIT; + request->send_buf = malloc(request->send_buf_size); + if (request->send_buf == NULL) { + SPDK_ERRLOG("Failed to allocate send_buf (%zu bytes)\n", request->send_buf_size); + conn->outstanding_requests--; + free(request); + return -1; + } + + if (rc < 0 || rc > SPDK_JSONRPC_MAX_VALUES) { + SPDK_DEBUGLOG(SPDK_LOG_RPC, "JSON parse error\n"); + spdk_jsonrpc_server_handle_error(request, SPDK_JSONRPC_ERROR_PARSE_ERROR); + + /* + * Can't recover from parse error (no guaranteed resync point in streaming JSON). + * Return an error to indicate that the connection should be closed. + */ + return -1; + } + + /* Decode a second time now that there is a full JSON value available. */ + rc = spdk_json_parse(json, size, conn->values, SPDK_JSONRPC_MAX_VALUES, &end, + SPDK_JSON_PARSE_FLAG_DECODE_IN_PLACE); + if (rc < 0 || rc > SPDK_JSONRPC_MAX_VALUES) { + SPDK_DEBUGLOG(SPDK_LOG_RPC, "JSON parse error on second pass\n"); + spdk_jsonrpc_server_handle_error(request, SPDK_JSONRPC_ERROR_PARSE_ERROR); + return -1; + } + + assert(end != NULL); + + if (conn->values[0].type == SPDK_JSON_VAL_OBJECT_BEGIN) { + parse_single_request(request, conn->values); + } else if (conn->values[0].type == SPDK_JSON_VAL_ARRAY_BEGIN) { + SPDK_DEBUGLOG(SPDK_LOG_RPC, "Got batch array (not currently supported)\n"); + spdk_jsonrpc_server_handle_error(request, SPDK_JSONRPC_ERROR_INVALID_REQUEST); + } else { + SPDK_DEBUGLOG(SPDK_LOG_RPC, "top-level JSON value was not array or object\n"); + spdk_jsonrpc_server_handle_error(request, SPDK_JSONRPC_ERROR_INVALID_REQUEST); + } + + return end - json; +} + +static int +spdk_jsonrpc_server_write_cb(void *cb_ctx, const void *data, size_t size) +{ + struct spdk_jsonrpc_request *request = cb_ctx; + size_t new_size = request->send_buf_size; + + while (new_size - request->send_len < size) { + if (new_size >= SPDK_JSONRPC_SEND_BUF_SIZE_MAX) { + SPDK_ERRLOG("Send buf exceeded maximum size (%zu)\n", + (size_t)SPDK_JSONRPC_SEND_BUF_SIZE_MAX); + return -1; + } + + new_size *= 2; + } + + if (new_size != request->send_buf_size) { + uint8_t *new_buf; + + new_buf = realloc(request->send_buf, new_size); + if (new_buf == NULL) { + SPDK_ERRLOG("Resizing send_buf failed (current size %zu, new size %zu)\n", + request->send_buf_size, new_size); + return -1; + } + + request->send_buf = new_buf; + request->send_buf_size = new_size; + } + + memcpy(request->send_buf + request->send_len, data, size); + request->send_len += size; + + return 0; +} + +static struct spdk_json_write_ctx * +begin_response(struct spdk_jsonrpc_request *request) +{ + struct spdk_json_write_ctx *w; + + w = spdk_json_write_begin(spdk_jsonrpc_server_write_cb, request, 0); + if (w == NULL) { + return NULL; + } + + spdk_json_write_object_begin(w); + spdk_json_write_name(w, "jsonrpc"); + spdk_json_write_string(w, "2.0"); + + spdk_json_write_name(w, "id"); + spdk_json_write_val(w, &request->id); + + return w; +} + +static void +skip_response(struct spdk_jsonrpc_request *request) +{ + request->send_len = 0; + spdk_jsonrpc_server_send_response(request); +} + +static void +end_response(struct spdk_jsonrpc_request *request, struct spdk_json_write_ctx *w) +{ + spdk_json_write_object_end(w); + spdk_json_write_end(w); + spdk_jsonrpc_server_write_cb(request, "\n", 1); + spdk_jsonrpc_server_send_response(request); +} + +void +spdk_jsonrpc_free_request(struct spdk_jsonrpc_request *request) +{ + request->conn->outstanding_requests--; + free(request->send_buf); + free(request); +} + +struct spdk_json_write_ctx * +spdk_jsonrpc_begin_result(struct spdk_jsonrpc_request *request) +{ + struct spdk_json_write_ctx *w; + + if (request->id.type == SPDK_JSON_VAL_INVALID) { + /* Notification - no response required */ + skip_response(request); + return NULL; + } + + w = begin_response(request); + if (w == NULL) { + skip_response(request); + return NULL; + } + + spdk_json_write_name(w, "result"); + + return w; +} + +void +spdk_jsonrpc_end_result(struct spdk_jsonrpc_request *request, struct spdk_json_write_ctx *w) +{ + assert(w != NULL); + + end_response(request, w); +} + +void +spdk_jsonrpc_send_error_response(struct spdk_jsonrpc_request *request, + int error_code, const char *msg) +{ + struct spdk_json_write_ctx *w; + + if (request->id.type == SPDK_JSON_VAL_INVALID) { + /* For error responses, if id is missing, explicitly respond with "id": null. */ + request->id.type = SPDK_JSON_VAL_NULL; + } + + w = begin_response(request); + if (w == NULL) { + skip_response(request); + return; + } + + spdk_json_write_name(w, "error"); + spdk_json_write_object_begin(w); + spdk_json_write_name(w, "code"); + spdk_json_write_int32(w, error_code); + spdk_json_write_name(w, "message"); + spdk_json_write_string(w, msg); + spdk_json_write_object_end(w); + + end_response(request, w); +} + +void +spdk_jsonrpc_send_error_response_fmt(struct spdk_jsonrpc_request *request, + int error_code, const char *fmt, ...) +{ + struct spdk_json_write_ctx *w; + va_list args; + + if (request->id.type == SPDK_JSON_VAL_INVALID) { + /* For error responses, if id is missing, explicitly respond with "id": null. */ + request->id.type = SPDK_JSON_VAL_NULL; + } + + w = begin_response(request); + if (w == NULL) { + skip_response(request); + return; + } + + spdk_json_write_name(w, "error"); + spdk_json_write_object_begin(w); + spdk_json_write_name(w, "code"); + spdk_json_write_int32(w, error_code); + spdk_json_write_name(w, "message"); + va_start(args, fmt); + spdk_json_write_string_fmt_v(w, fmt, args); + va_end(args); + spdk_json_write_object_end(w); + + end_response(request, w); +} + +SPDK_LOG_REGISTER_COMPONENT("rpc", SPDK_LOG_RPC) |