/*****************************************************************************\ * api.c - Slurm REST API openapi operations handlers ***************************************************************************** * Copyright (C) 2019-2020 SchedMD LLC. * Written by Nathan Rini * * This file is part of Slurm, a resource management program. * For details, see . * Please also read the included file: DISCLAIMER. * * Slurm is free software; you can redistribute it and/or modify it under * the terms of the GNU General Public License as published by the Free * Software Foundation; either version 2 of the License, or (at your option) * any later version. * * In addition, as a special exception, the copyright holders give permission * to link the code of portions of this program with the OpenSSL library under * certain conditions as described in each individual source file, and * distribute linked combinations including the two. You must obey the GNU * General Public License in all respects for all of the code used other than * OpenSSL. If you modify file(s) with this exception, you may extend this * exception to your version of the file(s), but you are not obligated to do * so. If you do not wish to do so, delete this exception statement from your * version. If you delete this exception statement from all source files in * the program, then also delete it here. * * Slurm is distributed in the hope that it will be useful, but WITHOUT ANY * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more * details. * * You should have received a copy of the GNU General Public License along * with Slurm; if not, write to the Free Software Foundation, Inc., * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. \*****************************************************************************/ #include "config.h" #include #include "slurm/slurm.h" #include "src/common/data.h" #include "src/common/log.h" #include "src/common/xassert.h" #include "src/common/xmalloc.h" #include "src/common/xstring.h" #include "src/slurmrestd/openapi.h" #include "src/slurmrestd/operations.h" #include "src/slurmrestd/ops/api.h" #include "src/slurmrestd/ref.h" #include "src/slurmrestd/xjson.h" typedef enum { URL_TAG_UNKNOWN = 0, URL_TAG_GENERATE, } url_tag_t; static int _op_handler_openapi(const char *context_id, http_request_method_t method, data_t *parameters, data_t *query, int tag, data_t *resp) { int rc; rc = data_copy(resp, get_openapi_specification()) ? SLURM_SUCCESS : SLURM_ERROR; return rc; } extern int init_op_openapi(void) { int rc; if ((rc = bind_operation_handler("/openapi.yaml", _op_handler_openapi, URL_TAG_GENERATE))) /* no-op */; else if ((rc = bind_operation_handler("/openapi.json", _op_handler_openapi, URL_TAG_GENERATE))) /* no-op */; else if ((rc = bind_operation_handler("/openapi", _op_handler_openapi, URL_TAG_GENERATE))) /* no-op */; else rc = bind_operation_handler("/openapi/v3", _op_handler_openapi, URL_TAG_GENERATE); return rc; } extern void destroy_op_openapi(void) { unbind_operation_handler(_op_handler_openapi); }