From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mx0b-002e3701.pphosted.com (mx0b-002e3701.pphosted.com [148.163.143.35]) by mx.groups.io with SMTP id smtpd.web10.7595.1607569120999105753 for ; Wed, 09 Dec 2020 18:58:41 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@hpe.com header.s=pps0720 header.b=Y1LuUrSL; spf=pass (domain: hpe.com, ip: 148.163.143.35, mailfrom: prvs=061307e4aa=nickle.wang@hpe.com) Received: from pps.filterd (m0134424.ppops.net [127.0.0.1]) by mx0b-002e3701.pphosted.com (8.16.0.43/8.16.0.43) with SMTP id 0BA2wPvX014245; Thu, 10 Dec 2020 02:58:40 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=hpe.com; h=from : to : cc : subject : date : message-id : references : in-reply-to : content-type : content-transfer-encoding : mime-version; s=pps0720; bh=xzVD5bVu+8zEWKJ9OS99gUlbCL95fXoMgVn91FIfRpI=; b=Y1LuUrSLBTCCEG2ahHgq95P7XIES4s5ubGiFHunpdLjUNMbe+oIjqDNl8iINrMAT9b3D diYQRmY7EnRsj1lhIzKmoPgF7G0cBNA8GutEDtyDtAai1Lu2g0nsRJf/fO8kbe0BQHWr vHKkAi0A2TkEBrYSoQRQOn5YfW8LsFe4tuD4mqqfbTnKCcRuBpKbK2c6BWsPErOq3fMj epOtmNV3Oxk1DfIkJhgrYo3IIG439l4lt7Wal8zJ2v+JwLjSAgH/N+GN21eV+Su1uGnE YpznV8kK/gEFlse5UUpvB2OxVERMv/3ck7yig3stWXyNvojnt0cfl02o75VLYIBDDFN3 Xw== Received: from g2t2354.austin.hpe.com (g2t2354.austin.hpe.com [15.233.44.27]) by mx0b-002e3701.pphosted.com with ESMTP id 35a719113p-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Thu, 10 Dec 2020 02:58:39 +0000 Received: from G9W8456.americas.hpqcorp.net (exchangepmrr1.us.hpecorp.net [16.216.161.95]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-SHA384 (256/256 bits)) (No client certificate requested) by g2t2354.austin.hpe.com (Postfix) with ESMTPS id C20D4A0; Thu, 10 Dec 2020 02:58:38 +0000 (UTC) Received: from G9W8455.americas.hpqcorp.net (2002:10d8:a15e::10d8:a15e) by G9W8456.americas.hpqcorp.net (2002:10d8:a15f::10d8:a15f) with Microsoft SMTP Server (TLS) id 15.0.1497.2; Thu, 10 Dec 2020 02:58:38 +0000 Received: from NAM12-MW2-obe.outbound.protection.outlook.com (15.241.52.12) by G9W8455.americas.hpqcorp.net (16.216.161.94) with Microsoft SMTP Server (TLS) id 15.0.1497.2 via Frontend Transport; Thu, 10 Dec 2020 02:58:38 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=lZ+mjwf0TGr9x2utrz4EwPNavNJoZavDoH1QAGHFYpk/+oEGLBzY4u57/qGC4z0YE8RUfMdF24xfqINq2JUrMd/MXd/oZ8RLtkdkYZqqdNPkCDVIjDqEV/QvTXEohrFM977QfuQdB36xT59IsWyUsly8/dcVOUdhrAQA91xBZGAWf92iWOXx/0aumWF5Fpwyac3ZPPkGL14NFuf1D0PkOchKUIZc1FxP72cg9dljDd0pMDjvcajrUju/TGe1BJ/N2budi0uGGjMWgEPyqpHRf3ALhaKDmfaZm4Mwfh93nPfHdHYsBg8mywe1qp2m5RnOvlePmT3wYNGGWL6ug8pNrw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=nXuPXDQdN7RNVqLXhhxY/loM5/CWp7uMMjoz5I4QjlE=; b=JYmLp0sEAgxCwwkXOEuPW0duuGYhdqH25dD0clFa+8wpzMXufMsPPjivVMz7Qd6T8t9II27gn2fa8mWS9OYWH6jIhfzaEKvE72SD4rBtju5bfjwblfF0w1GfzRs+AJmI0JYUXQzW1nwTbUrkbatVgscR9DwZIFEjhVeE4E++QTJAS3lZynMninx9NwYI2IMXaQKabpB9A3CGXztOy6XlO9+ZzF1Qnj95XlmuymoIq1t4xEANqLfD0LvDGS63700ITXVg1jEEhb1FR4FcFpXO9CoTy5MdhvleEkKN4TqL9veG6bdeafXOfpAGeUqDpo/0eaYj4D3D14qaWgTYWvDQMg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=hpe.com; dmarc=pass action=none header.from=hpe.com; dkim=pass header.d=hpe.com; arc=none Received: from DF4PR8401MB0812.NAMPRD84.PROD.OUTLOOK.COM (2a01:111:e400:760d::7) by DF4PR8401MB0508.NAMPRD84.PROD.OUTLOOK.COM (2a01:111:e400:760b::22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3654.12; Thu, 10 Dec 2020 02:58:35 +0000 Received: from DF4PR8401MB0812.NAMPRD84.PROD.OUTLOOK.COM ([fe80::e475:6a2b:ed1c:a060]) by DF4PR8401MB0812.NAMPRD84.PROD.OUTLOOK.COM ([fe80::e475:6a2b:ed1c:a060%11]) with mapi id 15.20.3654.014; Thu, 10 Dec 2020 02:58:35 +0000 From: "Nickle Wang" To: "Chang, Abner (HPS SW/FW Technologist)" , "devel@edk2.groups.io" CC: Leif Lindholm , "O'Hanley, Peter (EXL)" Subject: Re: [PATCH v5 4/6] RedfishPkg/library: EDK2 port of jansson library Thread-Topic: [PATCH v5 4/6] RedfishPkg/library: EDK2 port of jansson library Thread-Index: AQHWzQ3lYnjKr/jhMUKsFKTflRKzOqnvpokg Date: Thu, 10 Dec 2020 02:58:34 +0000 Message-ID: References: <20201208021048.9104-1-abner.chang@hpe.com> <20201208021048.9104-5-abner.chang@hpe.com> In-Reply-To: <20201208021048.9104-5-abner.chang@hpe.com> Accept-Language: zh-TW, en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: authentication-results: hpe.com; dkim=none (message not signed) header.d=none;hpe.com; dmarc=none action=none header.from=hpe.com; x-originating-ip: [2001:b011:5c04:5ee2:852e:ddde:5093:2eac] x-ms-publictraffictype: Email x-ms-office365-filtering-ht: Tenant x-ms-office365-filtering-correlation-id: 02a4ea62-1ee9-429e-d687-08d89cb77c48 x-ms-traffictypediagnostic: DF4PR8401MB0508: x-ms-exchange-transport-forked: True x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:10000; x-ms-exchange-senderadcheck: 1 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: gy4nni16FJc2crGqi92RHlbOO7FVJQXqwh6hBiHNTcoFNR7AxCJzb795B8r9hlIQJVYSY4jpBWY9A37ANRtnOQh3TVNBUivVFcpOwOWWMbb0x0NyWvq6/ir55oMTskPAxCa2RqfNrpfkZWrhEAAythufXFAKAel9nfCWw2PwIlKrSngv1C4p+5DtyWk85emGCuckyAuSuyL+y3MF14TRwgcBFCpSJh8GDm9rnHiaZTFqdP95EVLmtXDoPkL5uv/FVf3SOmv8hlK9LZtZIbBYfasXirPapF6mBQgKmab+VCRqQT5UX7UbETJg3lcS9ty0Hxp0nk0gJOqrliypm3OboQaxlvwejM7n7dFD7Q45kYdGlx43OofuL1lHXKmBkpVtQIFUfzfz++t43SMDCTkfYX7pclLdoisAtiaBhHPH4ZIaDbIz9dscjT0AYt052UHH3V3npGDdDoc7GsbaTNTHbA== x-forefront-antispam-report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:DF4PR8401MB0812.NAMPRD84.PROD.OUTLOOK.COM;PTR:;CAT:NONE;SFS:(346002)(376002)(136003)(366004)(7696005)(53546011)(55016002)(8676002)(45080400002)(76116006)(6506007)(110136005)(8936002)(86362001)(54906003)(9686003)(64756008)(966005)(5660300002)(186003)(52536014)(4326008)(71200400001)(66446008)(66946007)(66556008)(66476007)(33656002)(2906002)(30864003)(83380400001)(508600001)(2004002)(579004)(559001)(569008);DIR:OUT;SFP:1102; x-ms-exchange-antispam-messagedata: =?us-ascii?Q?G7R0X4kqZ0rwEnNYQq2wpuKD349/RxIk9Wrf4AW4F9OT6Lscl3r1rd7gf1HH?= =?us-ascii?Q?dtjiwh79RE2MkqSLrTSdXFDgUvYzPN+PmdsbHVMdgKelnpvkiocmLNE86cdz?= =?us-ascii?Q?SbNb/yDz1zCKOIcw/np5mTANhBGhfXmgDBgqkyKRAYZKxbHKaimw256vwQRJ?= =?us-ascii?Q?lHJTsa3dtiPrOtlTZXnI9Z2xoJHH5I4SEB6sVOl1iWY9px0nRunubsZzmp9m?= =?us-ascii?Q?oXdu47WoJuqNzsAfsIjXPXiKutEny7vOlzJ/SUD+7hrdYFL3TYGPr40ZQF8B?= =?us-ascii?Q?VyYhjoryVb21ekrknindNrF+oSOMLl6vQGxnXPgqH/LmDPtJZBrAjZ5GtGZ/?= =?us-ascii?Q?tujGf/oxRT2TtPA3264LGdiV5xaU4dpiVPflqW+a291JzP1B8uCqnMeNqyVh?= =?us-ascii?Q?PTQdW6pclciugw/LSP/GKZVn7l7zCAMI8aL68tl5TuVLivrj9RAT57kVkRv4?= =?us-ascii?Q?irKhPeRvlUeAxcNRfHDxRoREk75dUOEjnEgPxEH2hmPsBkZ5w5SRERvNIJKN?= =?us-ascii?Q?fSCLeAMF7SAMLO9u0c2IASIT8PNWVFTEWaYOcVxGRCWj/cZl0jJb4iiqgM9N?= =?us-ascii?Q?oWhYnzZb6jT4UwN0JRpsZdxwGUwTtGaxGOxOd7Fl8AavJLXeW10dO7nJS74g?= =?us-ascii?Q?SJjs3bTr0yxo4mhQ9RJQZkjEgnWEoYU53Joizat9TzWfFhWmfPsz6W6etFPG?= =?us-ascii?Q?alKG8sQjs5Vu5hz2/43StCPgyGSGwA1niLjKelFLYXh87Bm4CwUXVXMrlTec?= =?us-ascii?Q?ZBkIydUmvTOo+5MxdMnUSRQN877hTPd1UTORz+VmW+Z4Ts6tPyohaaoPEofi?= =?us-ascii?Q?PiMdjj6/XJBSRX0iYmGRnWp7giCL7xdXaYRBbB6/VgydDpQgIlLH7rJ/+P34?= =?us-ascii?Q?tdm7SRRfrLcXsm+F2oYc+4PXHp0EQRXOmHixUzpFkEAMmDLOVFVMPHsKlV2X?= =?us-ascii?Q?jq8oAi1RHqvHMDEURYHxWbJMvlEjx4B33CbaK9L3KYLVbUs8bQYh45tDfX5L?= =?us-ascii?Q?CAhNjAyDoHxbwM0Vi3cv4dQ6beQzI0PRmUeA9AKb9tR0nCk=3D?= X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: DF4PR8401MB0812.NAMPRD84.PROD.OUTLOOK.COM X-MS-Exchange-CrossTenant-Network-Message-Id: 02a4ea62-1ee9-429e-d687-08d89cb77c48 X-MS-Exchange-CrossTenant-originalarrivaltime: 10 Dec 2020 02:58:34.9052 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 105b2061-b669-4b31-92ac-24d304d195dc X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: 4D2fkoMzTywel+HfisQJFImHBU/RNCT4y0rvq1So06FCnQdVCNNWzs9ES2zZLNDVyk+CstJqOLNsUV8f/9fKZA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DF4PR8401MB0508 X-OriginatorOrg: hpe.com X-Proofpoint-UnRewURL: 0 URL was un-rewritten MIME-Version: 1.0 X-HPE-SCL: -1 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:6.0.343,18.0.737 definitions=2020-12-10_01:2020-12-09,2020-12-10 signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 malwarescore=0 suspectscore=0 adultscore=0 priorityscore=1501 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=999 lowpriorityscore=0 phishscore=0 impostorscore=0 clxscore=1015 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2012100019 Content-Language: en-US Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Reviewed-by: Nickle Wang > -----Original Message----- > From: Chang, Abner (HPS SW/FW Technologist) > Sent: Tuesday, December 8, 2020 10:11 AM > To: devel@edk2.groups.io > Cc: Leif Lindholm ; Wang, Nickle (HPS SW) > ; O'Hanley, Peter (EXL) > Subject: [PATCH v5 4/6] RedfishPkg/library: EDK2 port of jansson library >=20 > edk2 JsonLib which is the edk2 port of open source jansson library. > (https://github.com/akheron/jansson) > jansson library is the open source project to manipulate JSON data struct= ure. >=20 > Signed-off-by: Abner Chang >=20 > Cc: Leif Lindholm > Cc: Nickle Wang > Cc: Peter O'Hanley > --- > RedfishPkg/Include/JanssonJsonMapping.h | 63 + > RedfishPkg/Include/Library/JsonLib.h | 768 ++++++++++++ > RedfishPkg/Library/JsonLib/JsonLib.c | 961 ++++++++++++++ > RedfishPkg/Library/JsonLib/JsonLib.inf | 101 ++ > RedfishPkg/Library/JsonLib/Readme.rst | 40 + > RedfishPkg/Library/JsonLib/assert.h | 16 + > RedfishPkg/Library/JsonLib/errno.h | 16 + > RedfishPkg/Library/JsonLib/jansson_config.h | 46 + > .../Library/JsonLib/jansson_private_config.h | 19 + > RedfishPkg/Library/JsonLib/limits.h | 16 + > RedfishPkg/Library/JsonLib/load.c | 1111 +++++++++++++++++ > RedfishPkg/Library/JsonLib/math.h | 16 + > RedfishPkg/Library/JsonLib/stdarg.h | 15 + > RedfishPkg/Library/JsonLib/stddef.h | 16 + > RedfishPkg/Library/JsonLib/stdio.h | 15 + > RedfishPkg/Library/JsonLib/stdlib.h | 16 + > RedfishPkg/Library/JsonLib/string.h | 16 + > RedfishPkg/Library/JsonLib/sys/time.h | 15 + > RedfishPkg/Library/JsonLib/sys/types.h | 15 + > RedfishPkg/Library/JsonLib/time.h | 15 + > RedfishPkg/RedfishPkg.ci.yaml | 33 + > 21 files changed, 3329 insertions(+) > create mode 100644 RedfishPkg/Include/JanssonJsonMapping.h > create mode 100644 RedfishPkg/Include/Library/JsonLib.h > create mode 100644 RedfishPkg/Library/JsonLib/JsonLib.c > create mode 100644 RedfishPkg/Library/JsonLib/JsonLib.inf > create mode 100644 RedfishPkg/Library/JsonLib/Readme.rst > create mode 100644 RedfishPkg/Library/JsonLib/assert.h > create mode 100644 RedfishPkg/Library/JsonLib/errno.h > create mode 100644 RedfishPkg/Library/JsonLib/jansson_config.h > create mode 100644 RedfishPkg/Library/JsonLib/jansson_private_config.h > create mode 100644 RedfishPkg/Library/JsonLib/limits.h > create mode 100644 RedfishPkg/Library/JsonLib/load.c create mode 100644 > RedfishPkg/Library/JsonLib/math.h create mode 100644 > RedfishPkg/Library/JsonLib/stdarg.h > create mode 100644 RedfishPkg/Library/JsonLib/stddef.h > create mode 100644 RedfishPkg/Library/JsonLib/stdio.h > create mode 100644 RedfishPkg/Library/JsonLib/stdlib.h > create mode 100644 RedfishPkg/Library/JsonLib/string.h > create mode 100644 RedfishPkg/Library/JsonLib/sys/time.h > create mode 100644 RedfishPkg/Library/JsonLib/sys/types.h > create mode 100644 RedfishPkg/Library/JsonLib/time.h >=20 > diff --git a/RedfishPkg/Include/JanssonJsonMapping.h > b/RedfishPkg/Include/JanssonJsonMapping.h > new file mode 100644 > index 0000000000..80452d6663 > --- /dev/null > +++ b/RedfishPkg/Include/JanssonJsonMapping.h > @@ -0,0 +1,63 @@ > +/** @file > + This is the wrapper to map funcitons and definitions used in > + native jannson applications to edk2 JsonLib. This avoids the > + modifications on native jannson applications to be built under > + edk2 environment. > + > + (C) Copyright 2020 Hewlett Packard Enterprise Development LP
> + > + SPDX-License-Identifier: BSD-2-Clause-Patent > + > +**/ > + > +#ifndef LIBREDFISH_JSON_SUPPORT_H_ > +#define LIBREDFISH_JSON_SUPPORT_H_ > + > +#include > + > +typedef EDKII_JSON_VALUE json_t; > +typedef EDKII_JSON_INT_T json_int_t; > +typedef EDKII_JSON_TYPE json_type; > + > +/// > +/// JSON type mapping > +/// > +#define JSON_OBJECT EdkiiJsonTypeObject > +#define JSON_ARRAY EdkiiJsonTypeArray > +#define JSON_STRING EdkiiJsonTypeString > +#define JSON_INTEGER EdkiiJsonTypeInteger > +#define JSON_REAL EdkiiJsonTypeReal > +#define JSON_TRUE EdkiiJsonTypeTrue > +#define JSON_FALSE EdkiiJsonTypeFalse > +#define JSON_NULL EdkiiJsonTypeNull > + > +#define JSON_INDENT(n) EDKII_JSON_INDENT(n) > + > +/// > +/// JSON function mapping > +/// > +#define json_object_get(JsonObj,key) > JsonObjectGetValue(JsonObj,key) > +#define json_is_object(JsonValue) JsonValueIsObject(JsonV= alue) > +#define json_is_array(JsonValue) JsonValueIsArray(JsonVa= lue) > +#define json_is_string(JsonValue) JsonValueIsString(JsonV= alue) > +#define json_integer(JsonValue) JsonValueInitNumber(Jso= nValue) > +#define json_object_set(JsonObj,Key,JsonValue) > JsonObjectSetValue(JsonObj,Key,JsonValue) > +#define json_object() JsonValueInitObject() > +#define json_object_size(JsonObject) JsonObjectSize(JsonObje= ct) > +#define json_array_get(JsonArray,Index) > JsonArrayGetValue(JsonArray,Index) > +#define json_array_append(JsonArray,JsonValue) > JsonArrayAppendValue(JsonArray,JsonValue) > +#define json_dumps(JsonValue,Flags) > JsonDumpString(JsonValue,Flags) > +#define json_string_value(JsonValue) JsonValueGetString(Json= Value) > +#define json_array_size(JsonArray) JsonArrayCount(JsonArra= y) > +#define json_array() JsonValueInitArray() > +#define json_loadb(Buffer,BufferLen,Flags,Error) > JsonLoadBuffer(Buffer,BufferLen,Flags,Error) > +#define json_decref(JsonValue) > JsonDecreaseReference(JsonValue) > +#define json_incref(JsonValue) JsonIncreaseReference(J= sonValue) > +#define json_string(AsciiString) JsonValueInitAsciiStrin= g(AsciiString) > +#define json_object_iter(JsonValue) JsonObjectIterator(Json= Value) > +#define json_object_iter_value(Iterator) > JsonObjectIteratorValue(Iterator) > +#define json_object_iter_next(JsonValue,Iterator) > JsonObjectIteratorNext(JsonValue,Iterator) > +#define json_integer_value(JsonValue) > JsonValueGetNumber(JsonValue) > +#define json_get_type(JsonValue) JsonGetType(JsonValue) > + > +#endif > diff --git a/RedfishPkg/Include/Library/JsonLib.h > b/RedfishPkg/Include/Library/JsonLib.h > new file mode 100644 > index 0000000000..a7dcafebb3 > --- /dev/null > +++ b/RedfishPkg/Include/Library/JsonLib.h > @@ -0,0 +1,768 @@ > +/** @file > + APIs for JSON operations. > + > + Copyright (c) 2019, Intel Corporation. All rights reserved.
> + (C) Copyright 2020 Hewlett Packard Enterprise Development LP
> + > + SPDX-License-Identifier: BSD-2-Clause-Patent > + > +**/ > +#ifndef JSON_LIB_H_ > +#define JSON_LIB_H_ > + > +#include > + > +#include > +#include > + > +typedef VOID* EDKII_JSON_VALUE; > +typedef VOID* EDKII_JSON_ARRAY; > +typedef VOID* EDKII_JSON_OBJECT; > + > +/// > +/// Map to json_int_t in jansson.h > +/// > +typedef INT64 EDKII_JSON_INT_T; // #JSON_INTEGER_IS_LONG_LONG > is set to 1 > + // in jansson_Config.h > + > +/// > +/// Map to the definitions in jansson.h /// > +#define EDKII_JSON_MAX_INDENT 0x1F > +#define EDKII_JSON_INDENT(n) ((n) & EDKII_JSON_MAX_INDENT) > + > +#define EDKII_JSON_COMPACT 0x20 > +#define EDKII_JSON_ENSURE_ASCII 0x40 > +#define EDKII_JSON_SORT_KEYS 0x80 > +#define EDKII_JSON_PRESERVE_ORDER 0x100 > +#define EDKII_JSON_ENCODE_ANY 0x200 > +#define EDKII_JSON_ESCAPE_SLASH 0x400 > +#define EDKII_JSON_REAL_PRECISION(n) (((n) & 0x1F) << 11) > +#define EDKII_JSON_EMBED 0x10000 > + > +#define EDKII_JSON_ARRAY_FOREACH(Array, Index, Value) \ > + for(Index =3D 0; \ > + Index < JsonArrayCount(Array) && (Value =3D JsonArrayGetValue(Array, > Index)); \ > + Index++) > + > +/// > +/// Map to the json_error_t in jansson.h /// > +#define EDKII_JSON_ERROR_TEXT_LENGTH 160 > +#define EDKII_JSON_ERROR_SOURCE_LENGTH 80 typedef struct { > + INTN Line; > + INTN Column; > + INTN Position; > + CHAR8 Source [EDKII_JSON_ERROR_SOURCE_LENGTH]; > + CHAR8 Text [EDKII_JSON_ERROR_TEXT_LENGTH]; > +} EDKII_JSON_ERROR; > + > +/// > +/// Map to the json_type in jansson.h > +/// > +typedef enum { > + EdkiiJsonTypeObject, > + EdkiiJsonTypeArray, > + EdkiiJsonTypeString, > + EdkiiJsonTypeInteger, > + EdkiiJsonTypeReal, > + EdkiiJsonTypeTrue, > + EdkiiJsonTypeFalse, > + EdkiiJsonTypeNull > +} EDKII_JSON_TYPE; > + > +/** > + The function is used to convert a NULL terminated UTF8 encoded string > +to a JSON > + value. Only object and array represented strings can be converted > +successfully, > + since they are the only valid root values of a JSON text for UEFI usag= e. > + > + Real number and number with exponent part are not supportted by UEFI. > + > + Caller needs to cleanup the root value by calling JsonValueFree(). > + > + @param[in] Text The NULL terminated UTF8 encoded string = to > convert > + > + @retval Array JSON value or object JSON value, or NULL when any e= rror > occurs. > + > +**/ > +EDKII_JSON_VALUE > +EFIAPI > +TextToJson ( > + IN CHAR8* Text > + ); > + > +/** > + The function is used to convert the JSON root value to a UTF8 encoded > +string which > + is terminated by NULL, or return NULL on error. > + > + Only array JSON value or object JSON value is valid for converting, > + and caller is responsible for free converted string. > + > + @param[in] Json The JSON value to be converted > + > + @retval The JSON value converted UTF8 string or NULL. > + > +**/ > +CHAR8* > +EFIAPI > +JsonToText ( > + IN EDKII_JSON_VALUE Json > + ); > + > +/** > + The function is used to initialize a JSON value which contains a new > +JSON array, > + or NULL on error. Initially, the array is empty. > + > + The reference count of this value will be set to 1, and caller needs > + to cleanup the value by calling JsonValueFree(). > + > + More details for reference count strategy can refer to the API descrip= tion > for JsonValueFree(). > + > + @retval The created JSON value which contains a JSON array or NUL= L. > + > +**/ > +EDKII_JSON_VALUE > +EFIAPI > +JsonValueInitArray ( > + VOID > + ); > + > +/** > + The function is used to initialize a JSON value which contains a new > +JSON object, > + or NULL on error. Initially, the object is empty. > + > + The reference count of this value will be set to 1, and caller needs > + to cleanup the value by calling JsonValueFree(). > + > + More details for reference count strategy can refer to the API descrip= tion > for JsonValueFree(). > + > + @retval The created JSON value which contains a JSON object or NU= LL. > + > +**/ > +EDKII_JSON_VALUE > +EFIAPI > +JsonValueInitObject ( > + VOID > + ); > + > +/** > + The function is used to initialize a JSON value which contains a new > +JSON string, > + or NULL on error. > + > + The input string must be NULL terminated Ascii format, non-Ascii > + characters will be processed as an error. Unicode characters can also > + be represented by Ascii string as the format: \u + 4 hexadecimal digit= s, like > \u3E5A, or \u003F. > + > + The reference count of this value will be set to 1, and caller needs > + to cleanup the value by calling JsonValueFree(). > + > + More details for reference count strategy can refer to the API descrip= tion > for JsonValueFree(). > + > + @param[in] String The Ascii string to initialize to JSON value > + > + @retval The created JSON value which contains a JSON string or NU= LL. > Select a > + Getter API for a specific encoding format. > + > +**/ > +EDKII_JSON_VALUE > +EFIAPI > +JsonValueInitAsciiString ( > + IN CONST CHAR8 *String > + ); > + > +/** > + The function is used to initialize a JSON value which contains a new > +JSON string, > + or NULL on error. > + > + The input must be a NULL terminated UCS2 format Unicode string. > + > + The reference count of this value will be set to 1, and caller needs > + to cleanup the value by calling JsonValueFree(). > + > + More details for reference count strategy can refer to the API descrip= tion > for JsonValueFree(). > + > + @param[in] String The Unicode string to initialize to JSON value > + > + @retval The created JSON value which contains a JSON string or NU= LL. > Select a > + Getter API for a specific encoding format. > + > +**/ > +EDKII_JSON_VALUE > +EFIAPI > +JsonValueInitUnicodeString ( > + IN CHAR16 *String > + ); > + > +/** > + The function is used to initialize a JSON value which contains a new > +JSON integer, > + or NULL on error. > + > + The reference count of this value will be set to 1, and caller needs > + to cleanup the value by calling JsonValueFree(). > + > + More details for reference count strategy can refer to the API descrip= tion > for JsonValueFree(). > + > + @param[in] Value The integer to initialize to JSON value > + > + @retval The created JSON value which contains a JSON number or NU= LL. > + > +**/ > +EDKII_JSON_VALUE > +EFIAPI > +JsonValueInitNumber ( > + IN INT64 Value > + ); > + > +/** > + The function is used to initialize a JSON value which contains a new > +JSON boolean, > + or NULL on error. > + > + Boolean JSON value is kept as static value, and no need to do any clea= nup > work. > + > + @param[in] Value The boolean value to initialize. > + > + @retval The created JSON value which contains a JSON boolean or N= ULL. > + > +**/ > +EDKII_JSON_VALUE > +EFIAPI > +JsonValueInitBoolean ( > + IN BOOLEAN Value > + ); > + > +/** > + The function is used to initialize a JSON value which contains a new > +JSON NULL, > + or NULL on error. > + > + NULL JSON value is kept as static value, and no need to do any cleanup > work. > + > + @retval The created NULL JSON value. > + > +**/ > +EDKII_JSON_VALUE > +EFIAPI > +JsonValueInitNull ( > + VOID > + ); > + > +/** > + The function is used to decrease the reference count of a JSON value > +by one, and once > + this reference count drops to zero, the value is destroyed and it can = no > longer be used. > + If this destroyed value is object type or array type, reference > +counts for all containing > + JSON values will be decreased by 1. Boolean JSON value and NULL JSON > +value won't be destroyed > + since they are static values kept in memory. > + > + Reference Count Strategy: BaseJsonLib uses this strategy to track > + whether a value is still in use or not. When a value is created, it's > + reference count is set to 1. If a reference to a value is kept for > + use, its reference count is incremented, and when the value is no > + longer needed, the reference count is decremented. When the reference > count drops to zero, there are no references left, and the value can be > destroyed. > + > + The given JSON value maybe NULL and not causing any problem. Just > + output the debug message to inform caller the NULL value is passed in. > + > + @param[in] Json The JSON value to be freed. json_decref = may > return without any > + changes if Json is NULL. > + > +**/ > +VOID > +EFIAPI > +JsonValueFree ( > + IN EDKII_JSON_VALUE Json > + ); > + > +/** > + The function is used to create a fresh copy of a JSON value, and all > +child values are deep > + copied in a recursive fashion. It should be called when this JSON > +value might be modified > + in later use, but the original still wants to be used in somewhere els= e. > + > + Reference counts of the returned root JSON value and all child values > + will be set to 1, and caller needs to cleanup the root value by calling > JsonValueFree(). > + > + * Note: Since this function performs a copy from bottom to up, too > + many calls may cause some performance issues, user should avoid > + unnecessary calls to this function unless it is really needed. > + > + @param[in] Json The JSON value to be cloned. > + > + @retval Return the cloned JSON value, or NULL on error. > + > +**/ > +EDKII_JSON_VALUE > +EFIAPI > +JsonValueClone ( > + IN EDKII_JSON_VALUE Json > + ); > + > +/** > + The function is used to return if the provided JSON value contains a J= SON > array. > + > + @param[in] Json The provided JSON value. > + > + @retval TRUE The JSON value contains a JSON array. > + @retval FALSE The JSON value doesn't contain a JSON ar= ray. > + > +**/ > +BOOLEAN > +EFIAPI > +JsonValueIsArray ( > + IN EDKII_JSON_VALUE Json > + ); > + > +/** > + The function is used to return if the provided JSON value contains a J= SON > object. > + > + @param[in] Json The provided JSON value. > + > + @retval TRUE The JSON value contains a JSON object. > + @retval FALSE The JSON value doesn't contain a JSON ob= ject. > + > +**/ > +BOOLEAN > +EFIAPI > +JsonValueIsObject ( > + IN EDKII_JSON_VALUE Json > + ); > + > +/** > + The function is used to return if the provided JSON Value contains a > +string, Ascii or > + Unicode format is not differentiated. > + > + @param[in] Json The provided JSON value. > + > + @retval TRUE The JSON value contains a JSON string. > + @retval FALSE The JSON value doesn't contain a JSON st= ring. > + > +**/ > +BOOLEAN > +EFIAPI > +JsonValueIsString ( > + IN EDKII_JSON_VALUE Json > + ); > + > +/** > + The function is used to return if the provided JSON value contains a J= SON > number. > + > + @param[in] Json The provided JSON value. > + > + @retval TRUE The JSON value is contains JSON number. > + @retval FALSE The JSON value doesn't contain a JSON nu= mber. > + > +**/ > +BOOLEAN > +EFIAPI > +JsonValueIsNumber ( > + IN EDKII_JSON_VALUE Json > + ); > + > +/** > + The function is used to return if the provided JSON value contains a J= SON > boolean. > + > + @param[in] Json The provided JSON value. > + > + @retval TRUE The JSON value contains a JSON boolean. > + @retval FALSE The JSON value doesn't contain a JSON bo= olean. > + > +**/ > +BOOLEAN > +EFIAPI > +JsonValueIsBoolean ( > + IN EDKII_JSON_VALUE Json > + ); > + > +/** > + The function is used to return if the provided JSON value contains a J= SON > NULL. > + > + @param[in] Json The provided JSON value. > + > + @retval TRUE The JSON value contains a JSON NULL. > + @retval FALSE The JSON value doesn't contain a JSON NU= LL. > + > +**/ > +BOOLEAN > +EFIAPI > +JsonValueIsNull ( > + IN EDKII_JSON_VALUE Json > + ); > + > +/** > + The function is used to retrieve the associated array in an array type= JSON > value. > + > + Any changes to the returned array will impact the original JSON value. > + > + @param[in] Json The provided JSON value. > + > + @retval Return the associated array in JSON value or NULL. > + > +**/ > +EDKII_JSON_ARRAY > +EFIAPI > +JsonValueGetArray ( > + IN EDKII_JSON_VALUE Json > + ); > + > +/** > + The function is used to retrieve the associated object in an object ty= pe > JSON value. > + > + Any changes to the returned object will impact the original JSON value. > + > + @param[in] Json The provided JSON value. > + > + @retval Return the associated object in JSON value or NULL. > + > +**/ > +EDKII_JSON_OBJECT > +EFIAPI > +JsonValueGetObject ( > + IN EDKII_JSON_VALUE Json > + ); > + > +/** > + The function is used to retrieve the associated Ascii string in a stri= ng type > JSON value. > + > + Any changes to the returned string will impact the original JSON value. > + > + @param[in] Json The provided JSON value. > + > + @retval Return the associated Ascii string in JSON value or NULL. > + > +**/ > +CHAR8* > +EFIAPI > +JsonValueGetAsciiString ( > + IN EDKII_JSON_VALUE Json > + ); > + > +/** > + The function is used to retrieve the associated Unicode string in a st= ring > type JSON value. > + > + Caller can do any changes to the returned string without any impact > + to the original JSON value, and caller needs to free the returned stri= ng. > + > + @param[in] Json The provided JSON value. > + > + @retval Return the associated Unicode string in JSON value or NUL= L. > + > +**/ > +CHAR16* > +EFIAPI > +JsonValueGetUnicodeString ( > + IN EDKII_JSON_VALUE Json > + ); > + > +/** > + The function is used to retrieve the associated integer in a number ty= pe > JSON value. > + > + The input JSON value should not be NULL or contain no JSON number, > + otherwise it will > + ASSERT() and return 0. > + > + @param[in] Json The provided JSON value. > + > + @retval Return the associated number in JSON value. > + > +**/ > +INT64 > +EFIAPI > +JsonValueGetNumber ( > + IN EDKII_JSON_VALUE Json > + ); > + > +/** > + The function is used to retrieve the associated boolean in a boolean t= ype > JSON value. > + > + The input JSON value should not be NULL or contain no JSON boolean, > + otherwise it will > + ASSERT() and return FALSE. > + > + @param[in] Json The provided JSON value. > + > + @retval Return the associated value of JSON boolean. > + > +**/ > +BOOLEAN > +EFIAPI > +JsonValueGetBoolean ( > + IN EDKII_JSON_VALUE Json > + ); > + > +/** > + The function is used to retrieve the associated string in a string typ= e JSON > value. > + > + Any changes to the returned string will impact the original JSON value. > + > + @param[in] Json The provided JSON value. > + > + @retval Return the associated Ascii string in JSON value or NULL. > + > +**/ > +CONST CHAR8* > +EFIAPI > +JsonValueGetString ( > + IN EDKII_JSON_VALUE Json > + ); > + > +/** > + The function is used to get the number of elements in a JSON object, > +or 0 if it is NULL or > + not a JSON object. > + > + @param[in] JsonObject The provided JSON object. > + > + @retval Return the number of elements in this JSON object or 0. > + > +**/ > +UINTN > +EFIAPI > +JsonObjectSize ( > + IN EDKII_JSON_OBJECT JsonObject > + ); > + > +/** > + The function is used to enumerate all keys in a JSON object. > + > + Caller should be responsible to free the returned key array > + refference. But contained keys are read only and must not be modified = or > freed. > + > + @param[in] JsonObj The provided JSON object for enume= ration. > + @param[out] KeyCount The count of keys in this JSON obj= ect. > + > + @retval Return an array of the enumerated keys in this JSON objec= t or > NULL. > + > +**/ > +CHAR8** > +JsonObjectGetKeys ( > + IN EDKII_JSON_OBJECT JsonObj, > + OUT UINTN *KeyCount > + ); > + > +/** > + The function is used to get a JSON value corresponding to the input key > from a JSON object. > + > + It only returns a reference to this value and any changes on this > + value will impact the original JSON object. If that is not expected, > + please call JsonValueClone() to clone it to use. > + > + Input key must be a valid NULL terminated UTF8 encoded string. NULL > + will be returned when Key-Value is not found in this JSON object. > + > + @param[in] JsonObj The provided JSON object. > + @param[in] Key The key of the JSON value to be retriev= ed. > + > + @retval Return the corresponding JSON value to key, or NULL on er= ror. > + > +**/ > +EDKII_JSON_VALUE > +EFIAPI > +JsonObjectGetValue ( > + IN CONST EDKII_JSON_OBJECT JsonObj, > + IN CONST CHAR8 *Key > + ); > + > +/** > + The function is used to set a JSON value corresponding to the input > +key from a JSON object, > + and the reference count of this value will be increased by 1. > + > + Input key must be a valid NULL terminated UTF8 encoded string. If > + there already is a value for this key, this key will be assigned to > + the new JSON value. The old JSON value will be removed from this object > and thus its' reference count will be decreased by 1. > + > + More details for reference count strategy can refer to the API descrip= tion > for JsonValueFree(). > + > + @param[in] JsonObj The provided JSON object. > + @param[in] Key The key of the JSON value to be se= t. > + @param[in] Json The JSON value to set to this JSON= object > mapped by key. > + > + @retval EFI_ABORTED Some error occur and operation abo= rted. > + @retval EFI_SUCCESS The JSON value has been set to thi= s JSON > object. > + > +**/ > +EFI_STATUS > +EFIAPI > +JsonObjectSetValue ( > + IN EDKII_JSON_OBJECT JsonObj, > + IN CONST CHAR8 *Key, > + IN EDKII_JSON_VALUE Json > + ); > + > +/** > + The function is used to get the number of elements in a JSON array, > +or 0 if it is NULL or > + not a JSON array. > + > + @param[in] JsonArray The provided JSON array. > + > + @retval Return the number of elements in this JSON array or 0. > + > +**/ > +UINTN > +EFIAPI > +JsonArrayCount ( > + IN EDKII_JSON_ARRAY JsonArray > + ); > + > +/** > + The function is used to return the JSON value in the array at > +position index. The valid range > + for this index is from 0 to the return value of JsonArrayCount() minus= 1. > + > + It only returns a reference to this value and any changes on this > + value will impact the original JSON object. If that is not expected, > + please call JsonValueClone() to clone it to use. > + > + If this array is NULL or not a JSON array, or if index is out of range= , NULL will > be returned. > + > + @param[in] JsonArray The provided JSON Array. > + > + @retval Return the JSON value located in the Index position or NU= LL. > + > +**/ > +EDKII_JSON_VALUE > +EFIAPI > +JsonArrayGetValue ( > + IN EDKII_JSON_ARRAY JsonArray, > + IN UINTN Index > + ); > + > +/** > + The function is used to append a JSON value to the end of the JSON > +array, and grow the size of > + array by 1. The reference count of this value will be increased by 1. > + > + More details for reference count strategy can refer to the API descrip= tion > for JsonValueFree(). > + > + @param[in] JsonArray The provided JSON object. > + @param[in] Json The JSON value to append. > + > + @retval EFI_ABORTED Some error occur and operation abo= rted. > + @retval EFI_SUCCESS JSON value has been appended to th= e end > of the JSON array. > + > +**/ > +EFI_STATUS > +EFIAPI > +JsonArrayAppendValue ( > + IN EDKII_JSON_ARRAY JsonArray, > + IN EDKII_JSON_VALUE Json > + ); > + > +/** > + The function is used to remove a JSON value at position index, > +shifting the elements after index > + one position towards the start of the array. The reference count of > +this value will be decreased > + by 1. > + > + More details for reference count strategy can refer to the API descrip= tion > for JsonValueFree(). > + > + @param[in] JsonArray The provided JSON array. > + @param[in] Index The Index position before removeme= nt. > + > + @retval EFI_ABORTED Some error occur and operation abo= rted. > + @retval EFI_SUCCESS The JSON array has been removed at > position index. > + > +**/ > +EFI_STATUS > +EFIAPI > +JsonArrayRemoveValue ( > + IN EDKII_JSON_ARRAY JsonArray, > + IN UINTN Index > + ); > + > +/** > + Dump JSON to a buffer > + > + @param[in] JsonValue The provided JSON array. > + @param[in] Index The Index position before removement. > + > + @retval NULL Dump fail if NULL returned, otherwise the= buffer > + contain JSON paylaod in ASCII string. > +**/ > +CHAR8 * > +EFIAPI > +JsonDumpString ( > + IN EDKII_JSON_ARRAY JsonValue, > + IN UINTN Flags > + ); > + > +/** > + Load JSON from a buffer > + > + @param[in] Buffer Bufffer to the JSON payload > + @param[in] BufferLen Length of the buffer > + @param[in] Flags Flag of loading JSON buffer > + > + @retval EDKII_JSON_VALUE NULL means fail to load JSON payload. > +**/ > +EDKII_JSON_VALUE > +EFIAPI > +JsonLoadBuffer ( > + IN CONST CHAR8 *Buffer, > + IN UINTN BufferLen, > + IN UINTN Flags, > + IN EDKII_JSON_ERROR *Error > + ); > + > +/** > + Decrease reference > + > + @param[in] JsonValue JSON value > +**/ > +VOID > +EFIAPI > +JsonDecreaseReference ( > + IN EDKII_JSON_VALUE JsonValue > + ); > + > +/** > + Increase reference > + > + @param[in] JsonValue JSON value > + @retval EDKII_JSON_VALUE of itself > +**/ > +EDKII_JSON_VALUE > +EFIAPI > +JsonIncreaseReference ( > + IN EDKII_JSON_VALUE JsonValue > + ); > +/** > + Returns an opaque iterator which can be used to iterate over all > +key-value pairs > + in object, or NULL if object is empty > + > + @param[in] JsonValue JSON value > +**/ > +VOID * > +EFIAPI > +JsonObjectIterator ( > + IN EDKII_JSON_VALUE JsonValue > + ); > + > +/** > + Extract the associated value from iterator. > + > + @param[in] Iterator Iterator pointer > +**/ > +EDKII_JSON_VALUE > +EFIAPI > +JsonObjectIteratorValue ( > + IN VOID *Iterator > + ); > + > +/** > + Returns an iterator pointing to the next key-value pair in object > +after iter, > + or NULL if the whole object has been iterated through. > + > + @param[in] JsonValue JSON value > + @param[in] Iterator Iterator pointer > + @retval Iterator pointer > +**/ > +VOID * > +JsonObjectIteratorNext ( > + IN EDKII_JSON_VALUE JsonValue, > + IN VOID *Iterator > + ); > + > +/** > + Returns the json type of this json value > + > + @param[in] JsonValue JSON value > + @retval JSON type returned > +**/ > +EDKII_JSON_TYPE > +EFIAPI > +JsonGetType( > + IN EDKII_JSON_VALUE JsonValue > + ); > +#endif > diff --git a/RedfishPkg/Library/JsonLib/JsonLib.c > b/RedfishPkg/Library/JsonLib/JsonLib.c > new file mode 100644 > index 0000000000..b524ce6652 > --- /dev/null > +++ b/RedfishPkg/Library/JsonLib/JsonLib.c > @@ -0,0 +1,961 @@ > +/** @file > + APIs for JSON operations. > + > + Copyright (c) 2018 - 2019, Intel Corporation. All rights > + reserved.
> + (C) Copyright 2020 Hewlett Packard Enterprise Development LP
> + > + SPDX-License-Identifier: BSD-2-Clause-Patent **/ > + > +#include > +#include > +#include "jansson.h" > + > +/** > + The function is used to convert a NULL terminated UTF8 encoded string > +to a JSON > + value. Only object and array represented strings can be converted > +successfully, > + since they are the only valid root values of a JSON text for UEFI usag= e. > + > + Real number and number with exponent part are not supportted by UEFI. > + > + Caller needs to cleanup the root value by calling JsonValueFree(). > + > + @param[in] Text The NULL terminated UTF8 encoded string = to > convert > + > + @retval Array JSON value or object JSON value, or NULL when any e= rror > occurs. > + > +**/ > +EDKII_JSON_VALUE > +EFIAPI > +TextToJson ( > + IN CHAR8* Text > + ) > +{ > + json_error_t JsonError; > + > + return (EDKII_JSON_VALUE) json_loads (Text, 0, &JsonError); } > + > +/** > + The function is used to convert the JSON root value to a UTF8 encoded > +string which > + is terminated by NULL, or return NULL on error. > + > + Only array JSON value or object JSON value is valid for converting, > + and caller is responsible for free converted string. > + > + @param[in] Json The JSON value to be converted > + > + @retval The JSON value converted UTF8 string or NULL. > + > +**/ > +CHAR8* > +EFIAPI > +JsonToText ( > + IN EDKII_JSON_VALUE Json > + ) > +{ > + if (!JsonValueIsArray (Json) && !JsonValueIsObject (Json)) { > + return NULL; > + } > + > + return json_dumps ((json_t *)Json, 0); } > + > +/** > + The function is used to initialize a JSON value which contains a new > +JSON array, > + or NULL on error. Initially, the array is empty. > + > + The reference count of this value will be set to 1, and caller needs > + to cleanup the value by calling JsonValueFree(). > + > + More details for reference count strategy can refer to the API descrip= tion > for JsonValueFree(). > + > + @retval The created JSON value which contains a JSON array or NUL= L. > + > +**/ > +EDKII_JSON_VALUE > +EFIAPI > +JsonValueInitArray ( > + VOID > + ) > +{ > + return (EDKII_JSON_VALUE)json_array(); } > + > +/** > + The function is used to initialize a JSON value which contains a new > +JSON object, > + or NULL on error. Initially, the object is empty. > + > + The reference count of this value will be set to 1, and caller needs > + to cleanup the value by calling JsonValueFree(). > + > + More details for reference count strategy can refer to the API descrip= tion > for JsonValueFree(). > + > + @retval The created JSON value which contains a JSON object or NU= LL. > + > +**/ > +EDKII_JSON_VALUE > +EFIAPI > +JsonValueInitObject ( > + VOID > + ) > +{ > + return (EDKII_JSON_VALUE)json_object(); } > + > +/** > + The function is used to initialize a JSON value which contains a new > +JSON string, > + or NULL on error. > + > + The input string must be NULL terminated Ascii format, non-Ascii > + characters will be processed as an error. Unicode characters can also > + be represented by Ascii string as the format: \u + 4 hexadecimal digit= s, like > \u3E5A, or \u003F. > + > + The reference count of this value will be set to 1, and caller needs > + to cleanup the value by calling JsonValueFree(). > + > + More details for reference count strategy can refer to the API descrip= tion > for JsonValueFree(). > + > + @param[in] String The Ascii string to initialize to JSON value > + > + @retval The created JSON value which contains a JSON string or NU= LL. > Select a > + Getter API for a specific encoding format. > + > +**/ > +EDKII_JSON_VALUE > +EFIAPI > +JsonValueInitAsciiString ( > + IN CONST CHAR8 *String > + ) > +{ > + UINTN Index; > + > + if (String =3D=3D NULL) { > + return NULL; > + } > + > + Index =3D 0; > + while (*(String + Index) !=3D '\0') { > + if (((*(String + Index)) & 0x80) !=3D 0x00) { > + return NULL; > + } > + > + Index++; > + } > + > + return (EDKII_JSON_VALUE)json_string (String); } > + > +/** > + The function is used to initialize a JSON value which contains a new > +JSON string, > + or NULL on error. > + > + The input must be a NULL terminated UCS2 format Unicode string. > + > + The reference count of this value will be set to 1, and caller needs > + to cleanup the value by calling JsonValueFree(). > + > + More details for reference count strategy can refer to the API descrip= tion > for JsonValueFree(). > + > + @param[in] String The Unicode string to initialize to JSON value > + > + @retval The created JSON value which contains a JSON string or NU= LL. > Select a > + Getter API for a specific encoding format. > + > +**/ > +EDKII_JSON_VALUE > +EFIAPI > +JsonValueInitUnicodeString ( > + IN CHAR16 *String > + ) > +{ > + EFI_STATUS Status; > + CHAR8 *Utf8Str; > + > + if (String =3D=3D NULL) { > + return NULL; > + } > + > + Utf8Str =3D NULL; > + Status =3D UCS2StrToUTF8 (String, &Utf8Str); if (EFI_ERROR (Status)) > + { > + return NULL; > + } > + > + return (EDKII_JSON_VALUE)json_string (Utf8Str); } > + > +/** > + The function is used to initialize a JSON value which contains a new > +JSON integer, > + or NULL on error. > + > + The reference count of this value will be set to 1, and caller needs > + to cleanup the value by calling JsonValueFree(). > + > + More details for reference count strategy can refer to the API descrip= tion > for JsonValueFree(). > + > + @param[in] Value The integer to initialize to JSON value > + > + @retval The created JSON value which contains a JSON number or NU= LL. > + > +**/ > +EDKII_JSON_VALUE > +EFIAPI > +JsonValueInitNumber ( > + IN INT64 Value > + ) > +{ > + return (EDKII_JSON_VALUE)json_integer (Value); } > + > +/** > + The function is used to initialize a JSON value which contains a new > +JSON boolean, > + or NULL on error. > + > + Boolean JSON value is kept as static value, and no need to do any clea= nup > work. > + > + @param[in] Value The boolean value to initialize. > + > + @retval The created JSON value which contains a JSON boolean or N= ULL. > + > +**/ > +EDKII_JSON_VALUE > +EFIAPI > +JsonValueInitBoolean ( > + IN BOOLEAN Value > + ) > +{ > + return (EDKII_JSON_VALUE)json_boolean (Value); } > + > +/** > + The function is used to initialize a JSON value which contains a new > +JSON NULL, > + or NULL on error. > + > + NULL JSON value is kept as static value, and no need to do any cleanup > work. > + > + @retval The created NULL JSON value. > + > +**/ > +EDKII_JSON_VALUE > +EFIAPI > +JsonValueInitNull ( > + VOID > + ) > +{ > + return (EDKII_JSON_VALUE)json_null(); } > + > +/** > + The function is used to decrease the reference count of a JSON value > +by one, and once > + this reference count drops to zero, the value is destroyed and it can = no > longer be used. > + If this destroyed value is object type or array type, reference > +counts for all containing > + JSON values will be decreased by 1. Boolean JSON value and NULL JSON > +value won't be destroyed > + since they are static values kept in memory. > + > + Reference Count Strategy: BaseJsonLib uses this strategy to track > + whether a value is still in use or not. When a value is created, it's > + reference count is set to 1. If a reference to a value is kept for > + use, its reference count is incremented, and when the value is no > + longer needed, the reference count is decremented. When the reference > count drops to zero, there are no references left, and the value can be > destroyed. > + > + The given JSON value maybe NULL and not causing any problem. Just > + output the debug message to inform caller the NULL value is passed in. > + > + @param[in] Json The JSON value to be freed. json_decref = may > return without any > + changes if Json is NULL. > + > +**/ > +VOID > +EFIAPI > +JsonValueFree ( > + IN EDKII_JSON_VALUE Json > + ) > +{ > + json_decref((json_t *)Json); > +} > + > +/** > + The function is used to create a fresh copy of a JSON value, and all > +child values are deep > + copied in a recursive fashion. It should be called when this JSON > +value might be modified > + in later use, but the original still wants to be used in somewhere els= e. > + > + Reference counts of the returned root JSON value and all child values > + will be set to 1, and caller needs to cleanup the root value by calling > JsonValueFree(). > + > + * Note: Since this function performs a copy from bottom to up, too > + many calls may cause some performance issues, user should avoid > + unnecessary calls to this function unless it is really needed. > + > + @param[in] Json The JSON value to be cloned. > + > + @retval Return the cloned JSON value, or NULL on error. > + > +**/ > +EDKII_JSON_VALUE > +EFIAPI > +JsonValueClone ( > + IN EDKII_JSON_VALUE Json > + ) > +{ > + return (EDKII_JSON_VALUE)json_deep_copy ((json_t *) Json); } > + > +/** > + The function is used to return if the provided JSON value contains a J= SON > array. > + > + @param[in] Json The provided JSON value. > + > + @retval TRUE The JSON value contains a JSON array. > + @retval FALSE The JSON value doesn't contain a JSON ar= ray. > + > +**/ > +BOOLEAN > +EFIAPI > +JsonValueIsArray ( > + IN EDKII_JSON_VALUE Json > + ) > +{ > + return json_is_array ((json_t *) Json); } > + > +/** > + The function is used to return if the provided JSON value contains a J= SON > object. > + > + @param[in] Json The provided JSON value. > + > + @retval TRUE The JSON value contains a JSON object. > + @retval FALSE The JSON value doesn't contain a JSON ob= ject. > + > +**/ > +BOOLEAN > +EFIAPI > +JsonValueIsObject ( > + IN EDKII_JSON_VALUE Json > + ) > +{ > + return json_is_object ((json_t *) Json); } > + > +/** > + The function is used to return if the provided JSON Value contains a > +string, Ascii or > + Unicode format is not differentiated. > + > + @param[in] Json The provided JSON value. > + > + @retval TRUE The JSON value contains a JSON string. > + @retval FALSE The JSON value doesn't contain a JSON st= ring. > + > +**/ > +BOOLEAN > +EFIAPI > +JsonValueIsString ( > + IN EDKII_JSON_VALUE Json > + ) > +{ > + return json_is_string ((json_t *) Json); } > + > +/** > + The function is used to return if the provided JSON value contains a J= SON > number. > + > + @param[in] Json The provided JSON value. > + > + @retval TRUE The JSON value is contains JSON number. > + @retval FALSE The JSON value doesn't contain a JSON nu= mber. > + > +**/ > +BOOLEAN > +EFIAPI > +JsonValueIsNumber ( > + IN EDKII_JSON_VALUE Json > + ) > +{ > + return json_is_integer ((json_t *) Json); } > + > +/** > + The function is used to return if the provided JSON value contains a J= SON > boolean. > + > + @param[in] Json The provided JSON value. > + > + @retval TRUE The JSON value contains a JSON boolean. > + @retval FALSE The JSON value doesn't contain a JSON bo= olean. > + > +**/ > +BOOLEAN > +EFIAPI > +JsonValueIsBoolean ( > + IN EDKII_JSON_VALUE Json > + ) > +{ > + return json_is_boolean ((json_t *) Json); } > + > +/** > + The function is used to return if the provided JSON value contains a J= SON > NULL. > + > + @param[in] Json The provided JSON value. > + > + @retval TRUE The JSON value contains a JSON NULL. > + @retval FALSE The JSON value doesn't contain a JSON NU= LL. > + > +**/ > +BOOLEAN > +EFIAPI > +JsonValueIsNull ( > + IN EDKII_JSON_VALUE Json > + ) > +{ > + return json_is_null ((json_t *) Json); } > + > +/** > + The function is used to retrieve the associated array in an array type= JSON > value. > + > + Any changes to the returned array will impact the original JSON value. > + > + @param[in] Json The provided JSON value. > + > + @retval Return the associated array in JSON value or NULL. > + > +**/ > +EDKII_JSON_ARRAY > +EFIAPI > +JsonValueGetArray ( > + IN EDKII_JSON_VALUE Json > + ) > +{ > + if (Json =3D=3D NULL || !JsonValueIsArray (Json)) { > + return NULL; > + } > + > + return (EDKII_JSON_ARRAY)Json; > +} > + > +/** > + The function is used to retrieve the associated object in an object ty= pe > JSON value. > + > + Any changes to the returned object will impact the original JSON value. > + > + @param[in] Json The provided JSON value. > + > + @retval Return the associated object in JSON value or NULL. > + > +**/ > +EDKII_JSON_OBJECT > +EFIAPI > +JsonValueGetObject ( > + IN EDKII_JSON_VALUE Json > + ) > +{ > + if (Json =3D=3D NULL || !JsonValueIsObject (Json)) { > + return NULL; > + } > + > + return (EDKII_JSON_OBJECT)Json; > +} > + > +/** > + The function is used to retrieve the associated Ascii string in a stri= ng type > JSON value. > + > + Any changes to the returned string will impact the original JSON value. > + > + @param[in] Json The provided JSON value. > + > + @retval Return the associated Ascii string in JSON value or NULL. > + > +**/ > +CHAR8* > +EFIAPI > +JsonValueGetAsciiString ( > + IN EDKII_JSON_VALUE Json > + ) > +{ > + CHAR8 *AsciiStr; > + UINTN Index; > + > + AsciiStr =3D (CHAR8 *) ((json_t *) Json); if (AsciiStr =3D=3D NULL) { > + return NULL; > + } > + > + Index =3D 0; > + while (*(AsciiStr + Index) !=3D '\0') { > + if (((*(AsciiStr + Index)) & 0x80) !=3D 0x00) { > + return NULL; > + } > + > + Index++; > + } > + > + return AsciiStr; > +} > + > +/** > + The function is used to retrieve the associated Unicode string in a st= ring > type JSON value. > + > + Caller can do any changes to the returned string without any impact > + to the original JSON value, and caller needs to free the returned stri= ng. > + > + @param[in] Json The provided JSON value. > + > + @retval Return the associated Unicode string in JSON value or NUL= L. > + > +**/ > +CHAR16* > +EFIAPI > +JsonValueGetUnicodeString ( > + IN EDKII_JSON_VALUE Json > + ) > +{ > + EFI_STATUS Status; > + CONST CHAR8 *Utf8Str; > + CHAR16 *Ucs2Str; > + > + Utf8Str =3D json_string_value ((json_t *) Json); if (Utf8Str =3D=3D N= ULL) > + { > + return NULL; > + } > + > + Status =3D UTF8StrToUCS2 ((CHAR8*)Utf8Str, &Ucs2Str); if (EFI_ERROR > + (Status)) { > + return NULL; > + } > + > + return Ucs2Str; > +} > + > +/** > + The function is used to retrieve the associated integer in a number ty= pe > JSON value. > + > + The input JSON value should not be NULL or contain no JSON number, > + otherwise it will > + ASSERT() and return 0. > + > + @param[in] Json The provided JSON value. > + > + @retval Return the associated number in JSON value. > + > +**/ > +INT64 > +EFIAPI > +JsonValueGetNumber ( > + IN EDKII_JSON_VALUE Json > + ) > +{ > + ASSERT (Json !=3D NULL && JsonValueIsNumber (Json)); > + if (Json =3D=3D NULL || !JsonValueIsNumber (Json)) { > + return 0; > + } > + > + return json_integer_value ((json_t *) Json); } > + > +/** > + The function is used to retrieve the associated boolean in a boolean t= ype > JSON value. > + > + The input JSON value should not be NULL or contain no JSON boolean, > + otherwise it will > + ASSERT() and return FALSE. > + > + @param[in] Json The provided JSON value. > + > + @retval Return the associated value of JSON boolean. > + > +**/ > +BOOLEAN > +EFIAPI > +JsonValueGetBoolean ( > + IN EDKII_JSON_VALUE Json > + ) > +{ > + ASSERT (Json !=3D NULL && JsonValueIsBoolean (Json)); > + if (Json =3D=3D NULL || !JsonValueIsBoolean (Json)) { > + return FALSE; > + } > + > + return json_is_true ((json_t *) Json); } > + > +/** > + The function is used to retrieve the associated string in a string typ= e JSON > value. > + > + Any changes to the returned string will impact the original JSON value. > + > + @param[in] Json The provided JSON value. > + > + @retval Return the associated Ascii string in JSON value or NULL. > + > +**/ > +CONST CHAR8* > +EFIAPI > +JsonValueGetString ( > + IN EDKII_JSON_VALUE Json > + ) > +{ > + return json_string_value ((const json_t *)Json); } > + > +/** > + The function is used to get the number of elements in a JSON object, > +or 0 if it is NULL or > + not a JSON object. > + > + @param[in] JsonObject The provided JSON object. > + > + @retval Return the number of elements in this JSON object or 0. > + > +**/ > +UINTN > +EFIAPI > +JsonObjectSize ( > + IN EDKII_JSON_OBJECT JsonObject > + ) > +{ > + return json_object_size ((json_t *) JsonObject); } > + > +/** > + The function is used to enumerate all keys in a JSON object. > + > + Caller should be responsible to free the returned key array > + refference. But contained keys are read only and must not be modified = or > freed. > + > + @param[in] JsonObj The provided JSON object for enume= ration. > + @param[out] KeyCount The count of keys in this JSON obj= ect. > + > + @retval Return an array of the enumerated keys in this JSON objec= t or > NULL. > + > +**/ > +CHAR8** > +JsonObjectGetKeys ( > + IN EDKII_JSON_OBJECT JsonObj, > + OUT UINTN *KeyCount > + ) > +{ > + > + UINTN Index; > + CONST CHAR8 **KeyArray; > + CONST CHAR8 *Key; > + EDKII_JSON_VALUE Value; > + > + if (JsonObj =3D=3D NULL || KeyCount =3D=3D NULL) { > + return NULL; > + } > + > + Index =3D 0; > + json_object_foreach(JsonObj, Key, Value) { > + Index++; > + } > + if (Index =3D=3D 0) { > + *KeyCount =3D 0; > + return NULL; > + } > + > + *KeyCount =3D Index; > + KeyArray =3D (CONST CHAR8 **) AllocateZeroPool (*KeyCount * sizeof > + (CHAR8 *)); if (KeyArray =3D=3D NULL) { > + return NULL; > + } > + > + Key =3D NULL; > + Value =3D NULL; > + Index =3D 0; > + json_object_foreach((json_t *) JsonObj, Key, Value) { > + KeyArray[Index] =3D Key; > + Index++; > + } > + > + return (CHAR8 **)KeyArray; > +} > + > +/** > + The function is used to get a JSON value corresponding to the input key > from a JSON object. > + > + It only returns a reference to this value and any changes on this > + value will impact the original JSON object. If that is not expected, > + please call JsonValueClone() to clone it to use. > + > + Input key must be a valid NULL terminated UTF8 encoded string. NULL > + will be returned when Key-Value is not found in this JSON object. > + > + @param[in] JsonObj The provided JSON object. > + @param[in] Key The key of the JSON value to be retriev= ed. > + > + @retval Return the corresponding JSON value to key, or NULL on er= ror. > + > +**/ > +EDKII_JSON_VALUE > +EFIAPI > +JsonObjectGetValue ( > + IN CONST EDKII_JSON_OBJECT JsonObj, > + IN CONST CHAR8 *Key > + ) > +{ > + return (EDKII_JSON_VALUE)json_object_get ((const json_t *)JsonObj, > +(const char *)Key); } > + > +/** > + The function is used to set a JSON value corresponding to the input > +key from a JSON object, > + and the reference count of this value will be increased by 1. > + > + Input key must be a valid NULL terminated UTF8 encoded string. If > + there already is a value for this key, this key will be assigned to > + the new JSON value. The old JSON value will be removed from this object > and thus its' reference count will be decreased by 1. > + > + More details for reference count strategy can refer to the API descrip= tion > for JsonValueFree(). > + > + @param[in] JsonObj The provided JSON object. > + @param[in] Key The key of the JSON value to be se= t. > + @param[in] Json The JSON value to set to this JSON= object > mapped by key. > + > + @retval EFI_ABORTED Some error occur and operation abo= rted. > + @retval EFI_SUCCESS The JSON value has been set to thi= s JSON > object. > + > +**/ > +EFI_STATUS > +EFIAPI > +JsonObjectSetValue ( > + IN EDKII_JSON_OBJECT JsonObj, > + IN CONST CHAR8 *Key, > + IN EDKII_JSON_VALUE Json > + ) > +{ > + if (json_object_set ((json_t *) JsonObj, Key, (json_t *) Json) !=3D 0)= { > + return EFI_ABORTED; > + } else { > + return EFI_SUCCESS; > + } > +} > + > +/** > + The function is used to get the number of elements in a JSON array, > +or 0 if it is NULL or > + not a JSON array. > + > + @param[in] JsonArray The provided JSON array. > + > + @retval Return the number of elements in this JSON array or 0. > + > +**/ > +UINTN > +EFIAPI > +JsonArrayCount ( > + IN EDKII_JSON_ARRAY JsonArray > + ) > +{ > + return json_array_size ((json_t *) JsonArray); } > + > +/** > + The function is used to return the JSON value in the array at > +position index. The valid range > + for this index is from 0 to the return value of JsonArrayCount() minus= 1. > + > + It only returns a reference to this value and any changes on this > + value will impact the original JSON object. If that is not expected, > + please call JsonValueClone() to clone it to use. > + > + If this array is NULL or not a JSON array, or if index is out of range= , NULL will > be returned. > + > + @param[in] JsonArray The provided JSON Array. > + > + @retval Return the JSON value located in the Index position or NU= LL. > + > +**/ > +EDKII_JSON_VALUE > +EFIAPI > +JsonArrayGetValue ( > + IN EDKII_JSON_ARRAY JsonArray, > + IN UINTN Index > + ) > +{ > + return (EDKII_JSON_VALUE)json_array_get ((json_t *) JsonArray, > +Index); } > + > +/** > + The function is used to append a JSON value to the end of the JSON > +array, and grow the size of > + array by 1. The reference count of this value will be increased by 1. > + > + More details for reference count strategy can refer to the API descrip= tion > for JsonValueFree(). > + > + @param[in] JsonArray The provided JSON object. > + @param[in] Json The JSON value to append. > + > + @retval EFI_ABORTED Some error occur and operation abo= rted. > + @retval EFI_SUCCESS JSON value has been appended to th= e end > of the JSON array. > + > +**/ > +EFI_STATUS > +EFIAPI > +JsonArrayAppendValue ( > + IN EDKII_JSON_ARRAY JsonArray, > + IN EDKII_JSON_VALUE Json > + ) > +{ > + if (json_array_append ((json_t *) JsonArray, (json_t *) Json) !=3D 0) { > + return EFI_ABORTED; > + } else { > + return EFI_SUCCESS; > + } > +} > + > +/** > + The function is used to remove a JSON value at position index, > +shifting the elements after index > + one position towards the start of the array. The reference count of > +this value will be decreased > + by 1. > + > + More details for reference count strategy can refer to the API descrip= tion > for JsonValueFree(). > + > + @param[in] JsonArray The provided JSON array. > + @param[in] Index The Index position before removeme= nt. > + > + @retval EFI_ABORTED Some error occur and operation abo= rted. > + @retval EFI_SUCCESS The JSON array has been removed at > position index. > + > +**/ > +EFI_STATUS > +EFIAPI > +JsonArrayRemoveValue ( > + IN EDKII_JSON_ARRAY JsonArray, > + IN UINTN Index > + ) > +{ > + if (json_array_remove ((json_t *) JsonArray, Index) !=3D 0) { > + return EFI_ABORTED; > + } else { > + return EFI_SUCCESS; > + } > +} > + > +/** > + Dump JSON to a buffer. > + > + @param[in] JsonValue The provided JSON array. > + @param[in] Flags The Index position before removement. > + > + @retval NULL Dump fail if NULL returned, otherwise the= buffer > + contain JSON paylaod in ASCII string. > +**/ > +CHAR8 * > +EFIAPI > +JsonDumpString ( > + IN EDKII_JSON_ARRAY JsonValue, > + IN UINTN Flags > + ) > +{ > + if (JsonValue =3D=3D NULL) { > + return NULL; > + } > + return json_dumps((json_t *)JsonValue, Flags); } > + > +/** > + Load JSON from a buffer. > + > + @param[in] Buffer Bufffer to the JSON payload > + @param[in] BufferLen Length of the buffer > + @param[in] Flags Flag of loading JSON buffer > + @param[in] Error Pointer to error structure > + > + @retval EDKII_JSON_VALUE NULL means fail to load JSON payload. > +**/ > +EDKII_JSON_VALUE > +EFIAPI > +JsonLoadBuffer ( > + IN CONST CHAR8 *Buffer, > + IN UINTN BufferLen, > + IN UINTN Flags, > + IN EDKII_JSON_ERROR *Error > + ) > +{ > + return json_loadb(Buffer, BufferLen, Flags, (json_error_t *)Error); } > + > +/** > + Decrease reference. > + > + @param[in] JsonValue JSON value > +**/ > +VOID > +EFIAPI > +JsonDecreaseReference ( > + IN EDKII_JSON_VALUE JsonValue > + ) > +{ > + json_decref (JsonValue); > +} > + > +/** > + Increase reference. > + > + @param[in] JsonValue JSON value > + @retval EDKII_JSON_VALUE of itself > +**/ > +EDKII_JSON_VALUE > +EFIAPI > +JsonIncreaseReference ( > + IN EDKII_JSON_VALUE JsonValue > + ) > +{ > + return json_incref (JsonValue); > +} > + > +/** > + Returns an opaque iterator which can be used to iterate over all > +key-value pairs > + in object, or NULL if object is empty. > + > + @param[in] JsonValue JSON value > + @retval Iterator pointer > +**/ > +VOID * > +EFIAPI > +JsonObjectIterator ( > + IN EDKII_JSON_VALUE JsonValue > + ) > +{ > + return json_object_iter (JsonValue); > +} > + > +/** > + Extract the associated value from iterator. > + > + @param[in] Iterator Iterator pointer > + @retval EDKII_JSON_VALUE > +**/ > +EDKII_JSON_VALUE > +EFIAPI > +JsonObjectIteratorValue ( > + IN VOID *Iterator > + ) > +{ > + return json_object_iter_value(Iterator); } > + > +/** > + Returns an iterator pointing to the next key-value pair in object > +after iter, > + or NULL if the whole object has been iterated through. > + > + @param[in] JsonValue JSON value > + @param[in] Iterator Iterator pointer > + @retval Iterator pointer > +**/ > +VOID * > +JsonObjectIteratorNext ( > + IN EDKII_JSON_VALUE JsonValue, > + IN VOID *Iterator > + ) > +{ > + return json_object_iter_next(JsonValue, Iterator); } > + > +/** > + Returns the json type of this json value. > + > + @param[in] JsonValue JSON value > + @retval JSON type returned > +**/ > +EDKII_JSON_TYPE > +EFIAPI > +JsonGetType ( > + IN EDKII_JSON_VALUE JsonValue > + ) > +{ > + return ((json_t *)JsonValue)->type; > +} > diff --git a/RedfishPkg/Library/JsonLib/JsonLib.inf > b/RedfishPkg/Library/JsonLib/JsonLib.inf > new file mode 100644 > index 0000000000..8f44c506d8 > --- /dev/null > +++ b/RedfishPkg/Library/JsonLib/JsonLib.inf > @@ -0,0 +1,101 @@ > +## @file > +# Thirty party Jansson library for JSON operations. > +# > +# Copyright (c) 2019, Intel Corporation. All rights reserved.
# (C) > +Copyright 2020 Hewlett Packard Enterprise Development LP
# > +# SPDX-License-Identifier: BSD-2-Clause-Patent > +# > +## > + > +[Defines] > + INF_VERSION =3D 0x0001001b > + BASE_NAME =3D JsonLib > + FILE_GUID =3D F5E36815-305A-4C5A-9D75-4F2149E45255 > + MODULE_TYPE =3D DXE_DRIVER > + VERSION_STRING =3D 1.0 > + LIBRARY_CLASS =3D JsonLib|DXE_CORE DXE_DRIVER > DXE_RUNTIME_DRIVER DXE_SMM_DRIVER UEFI_APPLICATION > UEFI_DRIVER > + > +# > +# VALID_ARCHITECTURES =3D IA32 X64 ARM AARCH64 RISCV64 > +# > + > +[Sources] > + # > + # Below are the source code of third > + # party jansson library. > + # > + jansson/src/dump.c > + jansson/src/error.c > + jansson/src/hashtable.c > + jansson/src/hashtable_seed.c > + jansson/src/memory.c > + jansson/src/pack_unpack.c > + jansson/src/strbuffer.c > + jansson/src/strconv.c > + jansson/src/utf.c > + jansson/src/value.c > + jansson/src/version.c > + # > + # Below are the source of edk2 JsonLib. > + # > + JsonLib.c > + jansson_config.h > + jansson_private_config.h > + sys/time.h > + sys/types.h > + assert.h > + errno.h > + limits.h > + math.h > + stdarg.h > + stddef.h > + stdio.h > + stdlib.h > + string.h > + time.h > + # > + # Below is the source code override to fix the build issue. > + # Add code in load.c to conditionally use stdin according > + # to HAVE_UNISTD_H macro. The PR is submitted to jansson > + # open source community. > + # https://github.com/akheron/jansson/pull/558 > + # > + load.c > + > +[Packages] > + MdePkg/MdePkg.dec > + MdeModulePkg/MdeModulePkg.dec > + RedfishPkg/RedfishPkg.dec > + > +[LibraryClasses] > + BaseLib > + BaseMemoryLib > + Ucs2Utf8Lib > + CrtLib > + DebugLib > + MemoryAllocationLib > + PrintLib > + UefiRuntimeServicesTableLib > + UefiLib > + > +[BuildOptions] > + # > + # Disables the following Visual Studio compiler warnings > + # so we do not break the build with /WX option: > + # C4090: 'function' : different 'const' qualifiers > + # C4244: conversion from type1 to type2, possible loss of data > + # C4702: unreachable code > + # C4706: assignment within conditional expression > + # C4456: declaration hides previous local declaration > + # C4334: 32-bit shift implicitly converted to 64-bit > + # C4204: nonstandard extension used: non-constant aggregate initiali= zer > + # C4267: 'var' : conversion from 'size_t' to 'type', possible loss o= f data > + # > + # Define macro HAVE_CONFIG_H to include jansson_private_config.h to > build. > + # Undefined _WIN32, WIN64, _MSC_VER macros > + # On GCC, no error on the unused-function and unused-but-set-variable. > + # > + MSFT:*_*_*_CC_FLAGS =3D /wd4204 /wd4267 /wd4702 /wd4706 /wd4244 > /wd4090 > +/wd4456 /wd4334 /DHAVE_CONFIG_H=3D1 /U_WIN32 /UWIN64 > /U_MSC_VER > + GCC:*_*_*_CC_FLAGS =3D -Wno-unused-function > +-Wno-unused-but-set-variable > + > diff --git a/RedfishPkg/Library/JsonLib/Readme.rst > b/RedfishPkg/Library/JsonLib/Readme.rst > new file mode 100644 > index 0000000000..cc149196b9 > --- /dev/null > +++ b/RedfishPkg/Library/JsonLib/Readme.rst > @@ -0,0 +1,40 @@ > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > + Introduction > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > +=3D=3D=3D=3D=3D=3D > + Jansson is a C library for encoding, decoding and manipulating JSON da= ta. > +Its main features and design principles are: > + > + - Simple and intuitive API and data model > + - Comprehensive documentation > + - No dependencies on other libraries > + - Full Unicode support (UTF-8) > + - Extensive test suite > + > + Jansson is licensed under the MIT license(refer to ReadMe.rst under ed= k2). > +It is used in production and its API is stable. It works on numerous > +platforms, including numerous Unix like systems and Windows. It's > +suitable for use on any system, including desktop, server, and small > embedded systems. > + > + In UEFI/EDKII environment, Redfish project consumes jansson to > +achieve JSON operations. > + > +* Jansson version on edk2: 2.13.1 > + > +* EDKII jansson library wrapper: > + - JsonLib.h: > + This is the denifitions of EDKII JSON APIs which are mapped to > + jannson funcitons accordingly. > + > + - JanssonJsonLibMapping.h: > + This is the wrapper to map funcitons and definitions used in > + native jannson applications to edk2 JsonLib. This avoids the > + modifications on native jannson applications to be built under > + edk2 environment. > + > +*Known issue: > + Build fail with jansson/src/load.c, add code in load.c to conditional= ly > + use stdin according to HAVE_UNISTD_H macro. The PR is submitted to > + jansson open source community. > + https://github.com/akheron/jansson/pull/558 > + > + > diff --git a/RedfishPkg/Library/JsonLib/assert.h > b/RedfishPkg/Library/JsonLib/assert.h > new file mode 100644 > index 0000000000..f9ab7ef9ca > --- /dev/null > +++ b/RedfishPkg/Library/JsonLib/assert.h > @@ -0,0 +1,16 @@ > +/** @file > + Include file to support building the third-party jansson library. > + > + Copyright (c) 2019, Intel Corporation. All rights reserved.
> + (C) Copyright 2020 Hewlett Packard Enterprise Development LP
> + > + SPDX-License-Identifier: BSD-2-Clause-Patent > + > +**/ > + > +#ifndef CRT_ASSERT_H_ > +#define CRT_ASSERT_H_ > + > +#include > + > +#endif > diff --git a/RedfishPkg/Library/JsonLib/errno.h > b/RedfishPkg/Library/JsonLib/errno.h > new file mode 100644 > index 0000000000..d30aee14de > --- /dev/null > +++ b/RedfishPkg/Library/JsonLib/errno.h > @@ -0,0 +1,16 @@ > +/** @file > + Include file to support building the third-party jansson library. > + > + Copyright (c) 2019, Intel Corporation. All rights reserved.
> + (C) Copyright 2020 Hewlett Packard Enterprise Development LP
> + > + SPDX-License-Identifier: BSD-2-Clause-Patent > + > +**/ > + > +#ifndef CRT_ERRNO_H_ > +#define CRT_ERRNO_H_ > + > +#include > + > +#endif > diff --git a/RedfishPkg/Library/JsonLib/jansson_config.h > b/RedfishPkg/Library/JsonLib/jansson_config.h > new file mode 100644 > index 0000000000..fde5fec6dc > --- /dev/null > +++ b/RedfishPkg/Library/JsonLib/jansson_config.h > @@ -0,0 +1,46 @@ > +/** @file This is the configuration file for building jansson library. > + > + (C) Copyright 2020 Hewlett Packard Enterprise Development LP
> + > + SPDX-License-Identifier: BSD-2-Clause-Patent **/ > + > +#ifndef JANSSON_CONFIG_H_ > +#define JANSSON_CONFIG_H_ > + > +/// > +/// We don't support inline JSON on edk2 /// #define JSON_INLINE > + > +/// > +/// We support long long on edk2 > +/// > +#define JSON_INTEGER_IS_LONG_LONG 1 > + > +/// > +/// We don't support locale on edk2 > +/// > +#define JSON_HAVE_LOCALECONV 0 > + > +/// > +/// We don't support atomic builtins on edk2 /// #define > +JSON_HAVE_ATOMIC_BUILTINS 0 > + > +/// > +/// We don't support sync builtins on edk2 /// #define > +JSON_HAVE_SYNC_BUILTINS 0 > + > +/// > +/// Mzximum deepth is set to 2048 > +/// > +#define JSON_PARSER_MAX_DEPTH 2048 > + > +/// > +/// We support JSON real number on edk2 /// #define > +SUPPORT_JANSSON_JSON_REAL 1 > + > +#endif > diff --git a/RedfishPkg/Library/JsonLib/jansson_private_config.h > b/RedfishPkg/Library/JsonLib/jansson_private_config.h > new file mode 100644 > index 0000000000..268f91ef8a > --- /dev/null > +++ b/RedfishPkg/Library/JsonLib/jansson_private_config.h > @@ -0,0 +1,19 @@ > +/** @file > + Jansson private configurations for UEFI support. > + > + Copyright (c) 2019, Intel Corporation. All rights reserved.
> + (C) Copyright 2020 Hewlett Packard Enterprise Development LP
> + > + SPDX-License-Identifier: BSD-2-Clause-Patent > + > +**/ > + > +#ifndef JANSSON_PRIVATE_CONFIG_H_ > +#define JANSSON_PRIVATE_CONFIG_H_ > + > +#define HAVE_SYS_TIME_H 1 > +#define HAVE_SYS_TYPES_H 1 > + > +#define INITIAL_HASHTABLE_ORDER 3 > + > +#endif > diff --git a/RedfishPkg/Library/JsonLib/limits.h > b/RedfishPkg/Library/JsonLib/limits.h > new file mode 100644 > index 0000000000..f3bdd33f2a > --- /dev/null > +++ b/RedfishPkg/Library/JsonLib/limits.h > @@ -0,0 +1,16 @@ > +/** @file > + Include file to support building the third-party jansson library. > + > + Copyright (c) 2019, Intel Corporation. All rights reserved.
> + (C) Copyright 2020 Hewlett Packard Enterprise Development LP
> + > + SPDX-License-Identifier: BSD-2-Clause-Patent > + > +**/ > + > +#ifndef CRT_LIMITS_H_ > +#define CRT_LIMITS_H_ > + > +#include > + > +#endif > diff --git a/RedfishPkg/Library/JsonLib/load.c > b/RedfishPkg/Library/JsonLib/load.c > new file mode 100644 > index 0000000000..92063e63cb > --- /dev/null > +++ b/RedfishPkg/Library/JsonLib/load.c > @@ -0,0 +1,1111 @@ > +/* > + * Copyright (c) 2009-2016 Petri Lehtinen > + * > + * Jansson is free software; you can redistribute it and/or modify > + * it under the terms of the MIT license. See LICENSE for details. > + > + (C) Copyright 2020 Hewlett Packard Enterprise Development LP
> + > + SPDX-License-Identifier: BSD-2-Clause-Patent */ > + > +#ifndef _GNU_SOURCE > +#define _GNU_SOURCE > +#endif > + > +#include "jansson_private.h" > + > +#include > +#include > +#include > +#include > +#include > +#include > +#ifdef HAVE_UNISTD_H > +#include > +#endif > + > +#include "jansson.h" > +#include "strbuffer.h" > +#include "utf.h" > + > +#define STREAM_STATE_OK 0 > +#define STREAM_STATE_EOF -1 > +#define STREAM_STATE_ERROR -2 > + > +#define TOKEN_INVALID -1 > +#define TOKEN_EOF 0 > +#define TOKEN_STRING 256 > +#define TOKEN_INTEGER 257 > +#define TOKEN_REAL 258 > +#define TOKEN_TRUE 259 > +#define TOKEN_FALSE 260 > +#define TOKEN_NULL 261 > + > +/* Locale independent versions of isxxx() functions */ #define > +l_isupper(c) ('A' <=3D (c) && (c) <=3D 'Z') #define l_islower(c) ('a' <= =3D > +(c) && (c) <=3D 'z') #define l_isalpha(c) (l_isupper(c) || l_islower(c)) > +#define l_isdigit(c) ('0' <=3D (c) && (c) <=3D '9') > +#define l_isxdigit(c) = \ > + (l_isdigit(c) || ('A' <=3D (c) && (c) <=3D 'F') || ('a' <=3D (c) && = (c) > +<=3D 'f')) > + > +/* Read one byte from stream, convert to unsigned char, then int, and > + return. return EOF on end of file. This corresponds to the > + behaviour of fgetc(). */ > +typedef int (*get_func)(void *data); > + > +typedef struct { > + get_func get; > + void *data; > + char buffer[5]; > + size_t buffer_pos; > + int state; > + int line; > + int column, last_column; > + size_t position; > +} stream_t; > + > +typedef struct { > + stream_t stream; > + strbuffer_t saved_text; > + size_t flags; > + size_t depth; > + int token; > + union { > + struct { > + char *val; > + size_t len; > + } string; > + json_int_t integer; > + double real; > + } value; > +} lex_t; > + > +#define stream_to_lex(stream) container_of(stream, lex_t, stream) > + > +/*** error reporting ***/ > + > +static void error_set(json_error_t *error, const lex_t *lex, enum > json_error_code code, > + const char *msg, ...) { > + va_list ap; > + char msg_text[JSON_ERROR_TEXT_LENGTH]; > + char msg_with_context[JSON_ERROR_TEXT_LENGTH]; > + > + int line =3D -1, col =3D -1; > + size_t pos =3D 0; > + const char *result =3D msg_text; > + > + if (!error) > + return; > + > + va_start(ap, msg); > + vsnprintf(msg_text, JSON_ERROR_TEXT_LENGTH, msg, ap); > + msg_text[JSON_ERROR_TEXT_LENGTH - 1] =3D '\0'; > + va_end(ap); > + > + if (lex) { > + const char *saved_text =3D strbuffer_value(&lex->saved_text); > + > + line =3D lex->stream.line; > + col =3D lex->stream.column; > + pos =3D lex->stream.position; > + > + if (saved_text && saved_text[0]) { > + if (lex->saved_text.length <=3D 20) { > + snprintf(msg_with_context, JSON_ERROR_TEXT_LENGTH, "%s n= ear > '%s'", > + msg_text, saved_text); > + msg_with_context[JSON_ERROR_TEXT_LENGTH - 1] =3D '\0'; > + result =3D msg_with_context; > + } > + } else { > + if (code =3D=3D json_error_invalid_syntax) { > + /* More specific error code for premature end of file. */ > + code =3D json_error_premature_end_of_input; > + } > + if (lex->stream.state =3D=3D STREAM_STATE_ERROR) { > + /* No context for UTF-8 decoding errors */ > + result =3D msg_text; > + } else { > + snprintf(msg_with_context, JSON_ERROR_TEXT_LENGTH, "%s n= ear > end of file", > + msg_text); > + msg_with_context[JSON_ERROR_TEXT_LENGTH - 1] =3D '\0'; > + result =3D msg_with_context; > + } > + } > + } > + > + jsonp_error_set(error, line, col, pos, code, "%s", result); } > + > +/*** lexical analyzer ***/ > + > +static void stream_init(stream_t *stream, get_func get, void *data) { > + stream->get =3D get; > + stream->data =3D data; > + stream->buffer[0] =3D '\0'; > + stream->buffer_pos =3D 0; > + > + stream->state =3D STREAM_STATE_OK; > + stream->line =3D 1; > + stream->column =3D 0; > + stream->position =3D 0; > +} > + > +static int stream_get(stream_t *stream, json_error_t *error) { > + int c; > + > + if (stream->state !=3D STREAM_STATE_OK) > + return stream->state; > + > + if (!stream->buffer[stream->buffer_pos]) { > + c =3D stream->get(stream->data); > + if (c =3D=3D EOF) { > + stream->state =3D STREAM_STATE_EOF; > + return STREAM_STATE_EOF; > + } > + > + stream->buffer[0] =3D c; > + stream->buffer_pos =3D 0; > + > + if (0x80 <=3D c && c <=3D 0xFF) { > + /* multi-byte UTF-8 sequence */ > + size_t i, count; > + > + count =3D utf8_check_first(c); > + if (!count) > + goto out; > + > + assert(count >=3D 2); > + > + for (i =3D 1; i < count; i++) > + stream->buffer[i] =3D stream->get(stream->data); > + > + if (!utf8_check_full(stream->buffer, count, NULL)) > + goto out; > + > + stream->buffer[count] =3D '\0'; > + } else > + stream->buffer[1] =3D '\0'; > + } > + > + c =3D stream->buffer[stream->buffer_pos++]; > + > + stream->position++; > + if (c =3D=3D '\n') { > + stream->line++; > + stream->last_column =3D stream->column; > + stream->column =3D 0; > + } else if (utf8_check_first(c)) { > + /* track the Unicode character column, so increment only if > + this is the first character of a UTF-8 sequence */ > + stream->column++; > + } > + > + return c; > + > +out: > + stream->state =3D STREAM_STATE_ERROR; > + error_set(error, stream_to_lex(stream), json_error_invalid_utf8, > + "unable to decode byte 0x%x", c); > + return STREAM_STATE_ERROR; > +} > + > +static void stream_unget(stream_t *stream, int c) { > + if (c =3D=3D STREAM_STATE_EOF || c =3D=3D STREAM_STATE_ERROR) > + return; > + > + stream->position--; > + if (c =3D=3D '\n') { > + stream->line--; > + stream->column =3D stream->last_column; > + } else if (utf8_check_first(c)) > + stream->column--; > + > + assert(stream->buffer_pos > 0); > + stream->buffer_pos--; > + assert(stream->buffer[stream->buffer_pos] =3D=3D c); } > + > +static int lex_get(lex_t *lex, json_error_t *error) { > + return stream_get(&lex->stream, error); } > + > +static void lex_save(lex_t *lex, int c) { > +strbuffer_append_byte(&lex->saved_text, c); } > + > +static int lex_get_save(lex_t *lex, json_error_t *error) { > + int c =3D stream_get(&lex->stream, error); > + if (c !=3D STREAM_STATE_EOF && c !=3D STREAM_STATE_ERROR) > + lex_save(lex, c); > + return c; > +} > + > +static void lex_unget(lex_t *lex, int c) { stream_unget(&lex->stream, > +c); } > + > +static void lex_unget_unsave(lex_t *lex, int c) { > + if (c !=3D STREAM_STATE_EOF && c !=3D STREAM_STATE_ERROR) { > +/* Since we treat warnings as errors, when assertions are turned > + * off the "d" variable would be set but never used. Which is > + * treated as an error by GCC. > + */ > +#ifndef NDEBUG > + char d; > +#endif > + stream_unget(&lex->stream, c); > +#ifndef NDEBUG > + d =3D > +#endif > + strbuffer_pop(&lex->saved_text); > + assert(c =3D=3D d); > + } > +} > + > +static void lex_save_cached(lex_t *lex) { > + while (lex->stream.buffer[lex->stream.buffer_pos] !=3D '\0') { > + lex_save(lex, lex->stream.buffer[lex->stream.buffer_pos]); > + lex->stream.buffer_pos++; > + lex->stream.position++; > + } > +} > + > +static void lex_free_string(lex_t *lex) { > + jsonp_free(lex->value.string.val); > + lex->value.string.val =3D NULL; > + lex->value.string.len =3D 0; > +} > + > +/* assumes that str points to 'u' plus at least 4 valid hex digits */ > +static int32_t decode_unicode_escape(const char *str) { > + int i; > + int32_t value =3D 0; > + > + assert(str[0] =3D=3D 'u'); > + > + for (i =3D 1; i <=3D 4; i++) { > + char c =3D str[i]; > + value <<=3D 4; > + if (l_isdigit(c)) > + value +=3D c - '0'; > + else if (l_islower(c)) > + value +=3D c - 'a' + 10; > + else if (l_isupper(c)) > + value +=3D c - 'A' + 10; > + else > + return -1; > + } > + > + return value; > +} > + > +static void lex_scan_string(lex_t *lex, json_error_t *error) { > + int c; > + const char *p; > + char *t; > + int i; > + > + lex->value.string.val =3D NULL; > + lex->token =3D TOKEN_INVALID; > + > + c =3D lex_get_save(lex, error); > + > + while (c !=3D '"') { > + if (c =3D=3D STREAM_STATE_ERROR) > + goto out; > + > + else if (c =3D=3D STREAM_STATE_EOF) { > + error_set(error, lex, json_error_premature_end_of_input, > + "premature end of input"); > + goto out; > + } > + > + else if (0 <=3D c && c <=3D 0x1F) { > + /* control character */ > + lex_unget_unsave(lex, c); > + if (c =3D=3D '\n') > + error_set(error, lex, json_error_invalid_syntax, "unexpe= cted > newline"); > + else > + error_set(error, lex, json_error_invalid_syntax, "contro= l character > 0x%x", > + c); > + goto out; > + } > + > + else if (c =3D=3D '\\') { > + c =3D lex_get_save(lex, error); > + if (c =3D=3D 'u') { > + c =3D lex_get_save(lex, error); > + for (i =3D 0; i < 4; i++) { > + if (!l_isxdigit(c)) { > + error_set(error, lex, json_error_invalid_syntax, > + "invalid escape"); > + goto out; > + } > + c =3D lex_get_save(lex, error); > + } > + } else if (c =3D=3D '"' || c =3D=3D '\\' || c =3D=3D '/' || = c =3D=3D 'b' || c =3D=3D 'f' || > + c =3D=3D 'n' || c =3D=3D 'r' || c =3D=3D 't') > + c =3D lex_get_save(lex, error); > + else { > + error_set(error, lex, json_error_invalid_syntax, "invali= d escape"); > + goto out; > + } > + } else > + c =3D lex_get_save(lex, error); > + } > + > + /* the actual value is at most of the same length as the source > + string, because: > + - shortcut escapes (e.g. "\t") (length 2) are converted to 1 by= te > + - a single \uXXXX escape (length 6) is converted to at most 3 b= ytes > + - two \uXXXX escapes (length 12) forming an UTF-16 surrogate pa= ir > + are converted to 4 bytes > + */ > + t =3D jsonp_malloc(lex->saved_text.length + 1); > + if (!t) { > + /* this is not very nice, since TOKEN_INVALID is returned */ > + goto out; > + } > + lex->value.string.val =3D t; > + > + /* + 1 to skip the " */ > + p =3D strbuffer_value(&lex->saved_text) + 1; > + > + while (*p !=3D '"') { > + if (*p =3D=3D '\\') { > + p++; > + if (*p =3D=3D 'u') { > + size_t length; > + int32_t value; > + > + value =3D decode_unicode_escape(p); > + if (value < 0) { > + error_set(error, lex, json_error_invalid_syntax, > + "invalid Unicode escape '%.6s'", p - 1); > + goto out; > + } > + p +=3D 5; > + > + if (0xD800 <=3D value && value <=3D 0xDBFF) { > + /* surrogate pair */ > + if (*p =3D=3D '\\' && *(p + 1) =3D=3D 'u') { > + int32_t value2 =3D decode_unicode_escape(++p); > + if (value2 < 0) { > + error_set(error, lex, json_error_invalid_syn= tax, > + "invalid Unicode escape '%.6s'", p= - 1); > + goto out; > + } > + p +=3D 5; > + > + if (0xDC00 <=3D value2 && value2 <=3D 0xDFFF) { > + /* valid second surrogate */ > + value =3D > + ((value - 0xD800) << 10) + (value2 - 0xD= C00) + 0x10000; > + } else { > + /* invalid second surrogate */ > + error_set(error, lex, json_error_invalid_syn= tax, > + "invalid Unicode '\\u%04X\\u%04X'"= , value, value2); > + goto out; > + } > + } else { > + /* no second surrogate */ > + error_set(error, lex, json_error_invalid_syntax, > + "invalid Unicode '\\u%04X'", value); > + goto out; > + } > + } else if (0xDC00 <=3D value && value <=3D 0xDFFF) { > + error_set(error, lex, json_error_invalid_syntax, > + "invalid Unicode '\\u%04X'", value); > + goto out; > + } > + > + if (utf8_encode(value, t, &length)) > + assert(0); > + t +=3D length; > + } else { > + switch (*p) { > + case '"': > + case '\\': > + case '/': > + *t =3D *p; > + break; > + case 'b': > + *t =3D '\b'; > + break; > + case 'f': > + *t =3D '\f'; > + break; > + case 'n': > + *t =3D '\n'; > + break; > + case 'r': > + *t =3D '\r'; > + break; > + case 't': > + *t =3D '\t'; > + break; > + default: > + assert(0); > + } > + t++; > + p++; > + } > + } else > + *(t++) =3D *(p++); > + } > + *t =3D '\0'; > + lex->value.string.len =3D t - lex->value.string.val; > + lex->token =3D TOKEN_STRING; > + return; > + > +out: > + lex_free_string(lex); > +} > + > +#ifndef JANSSON_USING_CMAKE /* disabled if using cmake */ #if > +JSON_INTEGER_IS_LONG_LONG #ifdef _MSC_VER /* Microsoft Visual > Studio */ > +#define json_strtoint _strtoi64 #else #define json_strtoint strtoll > +#endif #else #define json_strtoint strtol #endif #endif > + > +static int lex_scan_number(lex_t *lex, int c, json_error_t *error) { > + const char *saved_text; > + char *end; > + double doubleval; > + > + lex->token =3D TOKEN_INVALID; > + > + if (c =3D=3D '-') > + c =3D lex_get_save(lex, error); > + > + if (c =3D=3D '0') { > + c =3D lex_get_save(lex, error); > + if (l_isdigit(c)) { > + lex_unget_unsave(lex, c); > + goto out; > + } > + } else if (l_isdigit(c)) { > + do > + c =3D lex_get_save(lex, error); > + while (l_isdigit(c)); > + } else { > + lex_unget_unsave(lex, c); > + goto out; > + } > + > + if (!(lex->flags & JSON_DECODE_INT_AS_REAL) && c !=3D '.' && c !=3D = 'E' && > c !=3D 'e') { > + json_int_t intval; > + > + lex_unget_unsave(lex, c); > + > + saved_text =3D strbuffer_value(&lex->saved_text); > + > + errno =3D 0; > + intval =3D json_strtoint(saved_text, &end, 10); > + if (errno =3D=3D ERANGE) { > + if (intval < 0) > + error_set(error, lex, json_error_numeric_overflow, > + "too big negative integer"); > + else > + error_set(error, lex, json_error_numeric_overflow, "too = big > integer"); > + goto out; > + } > + > + assert(end =3D=3D saved_text + lex->saved_text.length); > + > + lex->token =3D TOKEN_INTEGER; > + lex->value.integer =3D intval; > + return 0; > + } > + > + if (c =3D=3D '.') { > + c =3D lex_get(lex, error); > + if (!l_isdigit(c)) { > + lex_unget(lex, c); > + goto out; > + } > + lex_save(lex, c); > + > + do > + c =3D lex_get_save(lex, error); > + while (l_isdigit(c)); > + } > + > + if (c =3D=3D 'E' || c =3D=3D 'e') { > + c =3D lex_get_save(lex, error); > + if (c =3D=3D '+' || c =3D=3D '-') > + c =3D lex_get_save(lex, error); > + > + if (!l_isdigit(c)) { > + lex_unget_unsave(lex, c); > + goto out; > + } > + > + do > + c =3D lex_get_save(lex, error); > + while (l_isdigit(c)); > + } > + > + lex_unget_unsave(lex, c); > + > + if (jsonp_strtod(&lex->saved_text, &doubleval)) { > + error_set(error, lex, json_error_numeric_overflow, "real number > overflow"); > + goto out; > + } > + > + lex->token =3D TOKEN_REAL; > + lex->value.real =3D doubleval; > + return 0; > + > +out: > + return -1; > +} > + > +static int lex_scan(lex_t *lex, json_error_t *error) { > + int c; > + > + strbuffer_clear(&lex->saved_text); > + > + if (lex->token =3D=3D TOKEN_STRING) > + lex_free_string(lex); > + > + do > + c =3D lex_get(lex, error); > + while (c =3D=3D ' ' || c =3D=3D '\t' || c =3D=3D '\n' || c =3D=3D '\= r'); > + > + if (c =3D=3D STREAM_STATE_EOF) { > + lex->token =3D TOKEN_EOF; > + goto out; > + } > + > + if (c =3D=3D STREAM_STATE_ERROR) { > + lex->token =3D TOKEN_INVALID; > + goto out; > + } > + > + lex_save(lex, c); > + > + if (c =3D=3D '{' || c =3D=3D '}' || c =3D=3D '[' || c =3D=3D ']' || = c =3D=3D ':' || c =3D=3D ',') > + lex->token =3D c; > + > + else if (c =3D=3D '"') > + lex_scan_string(lex, error); > + > + else if (l_isdigit(c) || c =3D=3D '-') { > + if (lex_scan_number(lex, c, error)) > + goto out; > + } > + > + else if (l_isalpha(c)) { > + /* eat up the whole identifier for clearer error messages */ > + const char *saved_text; > + > + do > + c =3D lex_get_save(lex, error); > + while (l_isalpha(c)); > + lex_unget_unsave(lex, c); > + > + saved_text =3D strbuffer_value(&lex->saved_text); > + > + if (strcmp(saved_text, "true") =3D=3D 0) > + lex->token =3D TOKEN_TRUE; > + else if (strcmp(saved_text, "false") =3D=3D 0) > + lex->token =3D TOKEN_FALSE; > + else if (strcmp(saved_text, "null") =3D=3D 0) > + lex->token =3D TOKEN_NULL; > + else > + lex->token =3D TOKEN_INVALID; > + } > + > + else { > + /* save the rest of the input UTF-8 sequence to get an error > + message of valid UTF-8 */ > + lex_save_cached(lex); > + lex->token =3D TOKEN_INVALID; > + } > + > +out: > + return lex->token; > +} > + > +static char *lex_steal_string(lex_t *lex, size_t *out_len) { > + char *result =3D NULL; > + if (lex->token =3D=3D TOKEN_STRING) { > + result =3D lex->value.string.val; > + *out_len =3D lex->value.string.len; > + lex->value.string.val =3D NULL; > + lex->value.string.len =3D 0; > + } > + return result; > +} > + > +static int lex_init(lex_t *lex, get_func get, size_t flags, void *data) { > + stream_init(&lex->stream, get, data); > + if (strbuffer_init(&lex->saved_text)) > + return -1; > + > + lex->flags =3D flags; > + lex->token =3D TOKEN_INVALID; > + return 0; > +} > + > +static void lex_close(lex_t *lex) { > + if (lex->token =3D=3D TOKEN_STRING) > + lex_free_string(lex); > + strbuffer_close(&lex->saved_text); > +} > + > +/*** parser ***/ > + > +static json_t *parse_value(lex_t *lex, size_t flags, json_error_t > +*error); > + > +static json_t *parse_object(lex_t *lex, size_t flags, json_error_t *erro= r) { > + json_t *object =3D json_object(); > + if (!object) > + return NULL; > + > + lex_scan(lex, error); > + if (lex->token =3D=3D '}') > + return object; > + > + while (1) { > + char *key; > + size_t len; > + json_t *value; > + > + if (lex->token !=3D TOKEN_STRING) { > + error_set(error, lex, json_error_invalid_syntax, "string or = '}' > expected"); > + goto error; > + } > + > + key =3D lex_steal_string(lex, &len); > + if (!key) > + return NULL; > + if (memchr(key, '\0', len)) { > + jsonp_free(key); > + error_set(error, lex, json_error_null_byte_in_key, > + "NUL byte in object key not supported"); > + goto error; > + } > + > + if (flags & JSON_REJECT_DUPLICATES) { > + if (json_object_get(object, key)) { > + jsonp_free(key); > + error_set(error, lex, json_error_duplicate_key, "duplica= te object > key"); > + goto error; > + } > + } > + > + lex_scan(lex, error); > + if (lex->token !=3D ':') { > + jsonp_free(key); > + error_set(error, lex, json_error_invalid_syntax, "':' expect= ed"); > + goto error; > + } > + > + lex_scan(lex, error); > + value =3D parse_value(lex, flags, error); > + if (!value) { > + jsonp_free(key); > + goto error; > + } > + > + if (json_object_set_new_nocheck(object, key, value)) { > + jsonp_free(key); > + goto error; > + } > + > + jsonp_free(key); > + > + lex_scan(lex, error); > + if (lex->token !=3D ',') > + break; > + > + lex_scan(lex, error); > + } > + > + if (lex->token !=3D '}') { > + error_set(error, lex, json_error_invalid_syntax, "'}' expected"); > + goto error; > + } > + > + return object; > + > +error: > + json_decref(object); > + return NULL; > +} > + > +static json_t *parse_array(lex_t *lex, size_t flags, json_error_t *error= ) { > + json_t *array =3D json_array(); > + if (!array) > + return NULL; > + > + lex_scan(lex, error); > + if (lex->token =3D=3D ']') > + return array; > + > + while (lex->token) { > + json_t *elem =3D parse_value(lex, flags, error); > + if (!elem) > + goto error; > + > + if (json_array_append_new(array, elem)) { > + goto error; > + } > + > + lex_scan(lex, error); > + if (lex->token !=3D ',') > + break; > + > + lex_scan(lex, error); > + } > + > + if (lex->token !=3D ']') { > + error_set(error, lex, json_error_invalid_syntax, "']' expected"); > + goto error; > + } > + > + return array; > + > +error: > + json_decref(array); > + return NULL; > +} > + > +static json_t *parse_value(lex_t *lex, size_t flags, json_error_t *error= ) { > + json_t *json; > + > + lex->depth++; > + if (lex->depth > JSON_PARSER_MAX_DEPTH) { > + error_set(error, lex, json_error_stack_overflow, "maximum parsing > depth reached"); > + return NULL; > + } > + > + switch (lex->token) { > + case TOKEN_STRING: { > + const char *value =3D lex->value.string.val; > + size_t len =3D lex->value.string.len; > + > + if (!(flags & JSON_ALLOW_NUL)) { > + if (memchr(value, '\0', len)) { > + error_set(error, lex, json_error_null_character, > + "\\u0000 is not allowed without JSON_ALLOW= _NUL"); > + return NULL; > + } > + } > + > + json =3D jsonp_stringn_nocheck_own(value, len); > + lex->value.string.val =3D NULL; > + lex->value.string.len =3D 0; > + break; > + } > + > + case TOKEN_INTEGER: { > + json =3D json_integer(lex->value.integer); > + break; > + } > + > + case TOKEN_REAL: { > + json =3D json_real(lex->value.real); > + break; > + } > + > + case TOKEN_TRUE: > + json =3D json_true(); > + break; > + > + case TOKEN_FALSE: > + json =3D json_false(); > + break; > + > + case TOKEN_NULL: > + json =3D json_null(); > + break; > + > + case '{': > + json =3D parse_object(lex, flags, error); > + break; > + > + case '[': > + json =3D parse_array(lex, flags, error); > + break; > + > + case TOKEN_INVALID: > + error_set(error, lex, json_error_invalid_syntax, "invalid to= ken"); > + return NULL; > + > + default: > + error_set(error, lex, json_error_invalid_syntax, "unexpected= token"); > + return NULL; > + } > + > + if (!json) > + return NULL; > + > + lex->depth--; > + return json; > +} > + > +static json_t *parse_json(lex_t *lex, size_t flags, json_error_t *error)= { > + json_t *result; > + > + lex->depth =3D 0; > + > + lex_scan(lex, error); > + if (!(flags & JSON_DECODE_ANY)) { > + if (lex->token !=3D '[' && lex->token !=3D '{') { > + error_set(error, lex, json_error_invalid_syntax, "'[' or '{'= expected"); > + return NULL; > + } > + } > + > + result =3D parse_value(lex, flags, error); > + if (!result) > + return NULL; > + > + if (!(flags & JSON_DISABLE_EOF_CHECK)) { > + lex_scan(lex, error); > + if (lex->token !=3D TOKEN_EOF) { > + error_set(error, lex, json_error_end_of_input_expected, > + "end of file expected"); > + json_decref(result); > + return NULL; > + } > + } > + > + if (error) { > + /* Save the position even though there was no error */ > + error->position =3D (int)lex->stream.position; > + } > + > + return result; > +} > + > +typedef struct { > + const char *data; > + size_t pos; > +} string_data_t; > + > +static int string_get(void *data) { > + char c; > + string_data_t *stream =3D (string_data_t *)data; > + c =3D stream->data[stream->pos]; > + if (c =3D=3D '\0') > + return EOF; > + else { > + stream->pos++; > + return (unsigned char)c; > + } > +} > + > +json_t *json_loads(const char *string, size_t flags, json_error_t *error= ) { > + lex_t lex; > + json_t *result; > + string_data_t stream_data; > + > + jsonp_error_init(error, ""); > + > + if (string =3D=3D NULL) { > + error_set(error, NULL, json_error_invalid_argument, "wrong > arguments"); > + return NULL; > + } > + > + stream_data.data =3D string; > + stream_data.pos =3D 0; > + > + if (lex_init(&lex, string_get, flags, (void *)&stream_data)) > + return NULL; > + > + result =3D parse_json(&lex, flags, error); > + > + lex_close(&lex); > + return result; > +} > + > +typedef struct { > + const char *data; > + size_t len; > + size_t pos; > +} buffer_data_t; > + > +static int buffer_get(void *data) { > + char c; > + buffer_data_t *stream =3D data; > + if (stream->pos >=3D stream->len) > + return EOF; > + > + c =3D stream->data[stream->pos]; > + stream->pos++; > + return (unsigned char)c; > +} > + > +json_t *json_loadb(const char *buffer, size_t buflen, size_t flags, > json_error_t *error) { > + lex_t lex; > + json_t *result; > + buffer_data_t stream_data; > + > + jsonp_error_init(error, ""); > + > + if (buffer =3D=3D NULL) { > + error_set(error, NULL, json_error_invalid_argument, "wrong > arguments"); > + return NULL; > + } > + > + stream_data.data =3D buffer; > + stream_data.pos =3D 0; > + stream_data.len =3D buflen; > + > + if (lex_init(&lex, buffer_get, flags, (void *)&stream_data)) > + return NULL; > + > + result =3D parse_json(&lex, flags, error); > + > + lex_close(&lex); > + return result; > +} > + > +json_t *json_loadf(FILE *input, size_t flags, json_error_t *error) { > + lex_t lex; > + const char *source; > + json_t *result; > +#ifdef HAVE_UNISTD_H > + if (input =3D=3D stdin) > + source =3D ""; > + else > +#endif > + source =3D ""; > + > + jsonp_error_init(error, source); > + > + if (input =3D=3D NULL) { > + error_set(error, NULL, json_error_invalid_argument, "wrong > arguments"); > + return NULL; > + } > + > + if (lex_init(&lex, (get_func)fgetc, flags, input)) > + return NULL; > + > + result =3D parse_json(&lex, flags, error); > + > + lex_close(&lex); > + return result; > +} > + > +static int fd_get_func(int *fd) { > +#ifdef HAVE_UNISTD_H > + uint8_t c; > + if (read(*fd, &c, 1) =3D=3D 1) > + return c; > +#endif > + return EOF; > +} > + > +json_t *json_loadfd(int input, size_t flags, json_error_t *error) { > + lex_t lex; > + const char *source; > + json_t *result; > + > +#ifdef HAVE_UNISTD_H > + if (input =3D=3D STDIN_FILENO) > + source =3D ""; > + else > +#endif > + source =3D ""; > + > + jsonp_error_init(error, source); > + > + if (input < 0) { > + error_set(error, NULL, json_error_invalid_argument, "wrong > arguments"); > + return NULL; > + } > + > + if (lex_init(&lex, (get_func)fd_get_func, flags, &input)) > + return NULL; > + > + result =3D parse_json(&lex, flags, error); > + > + lex_close(&lex); > + return result; > +} > + > +json_t *json_load_file(const char *path, size_t flags, json_error_t *err= or) { > + json_t *result; > + FILE *fp; > + > + jsonp_error_init(error, path); > + > + if (path =3D=3D NULL) { > + error_set(error, NULL, json_error_invalid_argument, "wrong > arguments"); > + return NULL; > + } > + > + fp =3D fopen(path, "rb"); > + if (!fp) { > + error_set(error, NULL, json_error_cannot_open_file, "unable to o= pen > %s: %s", path, > + strerror(errno)); > + return NULL; > + } > + > + result =3D json_loadf(fp, flags, error); > + > + fclose(fp); > + return result; > +} > + > +#define MAX_BUF_LEN 1024 > + > +typedef struct { > + char data[MAX_BUF_LEN]; > + size_t len; > + size_t pos; > + json_load_callback_t callback; > + void *arg; > +} callback_data_t; > + > +static int callback_get(void *data) { > + char c; > + callback_data_t *stream =3D data; > + > + if (stream->pos >=3D stream->len) { > + stream->pos =3D 0; > + stream->len =3D stream->callback(stream->data, MAX_BUF_LEN, stre= am- > >arg); > + if (stream->len =3D=3D 0 || stream->len =3D=3D (size_t)-1) > + return EOF; > + } > + > + c =3D stream->data[stream->pos]; > + stream->pos++; > + return (unsigned char)c; > +} > + > +json_t *json_load_callback(json_load_callback_t callback, void *arg, siz= e_t > flags, > + json_error_t *error) { > + lex_t lex; > + json_t *result; > + > + callback_data_t stream_data; > + > + memset(&stream_data, 0, sizeof(stream_data)); > + stream_data.callback =3D callback; > + stream_data.arg =3D arg; > + > + jsonp_error_init(error, ""); > + > + if (callback =3D=3D NULL) { > + error_set(error, NULL, json_error_invalid_argument, "wrong > arguments"); > + return NULL; > + } > + > + if (lex_init(&lex, (get_func)callback_get, flags, &stream_data)) > + return NULL; > + > + result =3D parse_json(&lex, flags, error); > + > + lex_close(&lex); > + return result; > +} > diff --git a/RedfishPkg/Library/JsonLib/math.h > b/RedfishPkg/Library/JsonLib/math.h > new file mode 100644 > index 0000000000..984c0ccc21 > --- /dev/null > +++ b/RedfishPkg/Library/JsonLib/math.h > @@ -0,0 +1,16 @@ > +/** @file > + Include file to support building the third-party jansson library. > + > + Copyright (c) 2019, Intel Corporation. All rights reserved.
> + (C) Copyright 2020 Hewlett Packard Enterprise Development LP
> + > + SPDX-License-Identifier: BSD-2-Clause-Patent > + > +**/ > + > +#ifndef CRT_MATH_H_ > +#define CRT_MATH_H_ > + > +#include > + > +#endif > diff --git a/RedfishPkg/Library/JsonLib/stdarg.h > b/RedfishPkg/Library/JsonLib/stdarg.h > new file mode 100644 > index 0000000000..d5a314ad3b > --- /dev/null > +++ b/RedfishPkg/Library/JsonLib/stdarg.h > @@ -0,0 +1,15 @@ > +/** @file > + Include file to support building the third-party jansson library. > + > + Copyright (c) 2019, Intel Corporation. All rights reserved.
> + (C) Copyright 2020 Hewlett Packard Enterprise Development LP
> + > + SPDX-License-Identifier: BSD-2-Clause-Patent > + > +**/ > +#ifndef CRT_STDARG_H_ > +#define CRT_STDARG_H_ > + > +#include > + > +#endif > diff --git a/RedfishPkg/Library/JsonLib/stddef.h > b/RedfishPkg/Library/JsonLib/stddef.h > new file mode 100644 > index 0000000000..15a37bf50e > --- /dev/null > +++ b/RedfishPkg/Library/JsonLib/stddef.h > @@ -0,0 +1,16 @@ > +/** @file > + Include file to support building the third-party jansson library. > + > + Copyright (c) 2019, Intel Corporation. All rights reserved.
> + (C) Copyright 2020 Hewlett Packard Enterprise Development LP
> + > + SPDX-License-Identifier: BSD-2-Clause-Patent > + > +**/ > + > +#ifndef CRT_STDDEF_H_ > +#define CRT_STDDEF_H_ > + > +#include > + > +#endif > diff --git a/RedfishPkg/Library/JsonLib/stdio.h > b/RedfishPkg/Library/JsonLib/stdio.h > new file mode 100644 > index 0000000000..25e610be10 > --- /dev/null > +++ b/RedfishPkg/Library/JsonLib/stdio.h > @@ -0,0 +1,15 @@ > +/** @file > + Include file to support building the third-party jansson library. > + > + Copyright (c) 2019, Intel Corporation. All rights reserved.
> + (C) Copyright 2020 Hewlett Packard Enterprise Development LP
> + > + SPDX-License-Identifier: BSD-2-Clause-Patent > + > +**/ > +#ifndef CRT_STDIO_H_ > +#define CRT_STDIO_H_ > + > +#include > + > +#endif > diff --git a/RedfishPkg/Library/JsonLib/stdlib.h > b/RedfishPkg/Library/JsonLib/stdlib.h > new file mode 100644 > index 0000000000..5b3dd273c8 > --- /dev/null > +++ b/RedfishPkg/Library/JsonLib/stdlib.h > @@ -0,0 +1,16 @@ > +/** @file > + Include file to support building the third-party jansson library. > + > + Copyright (c) 2019, Intel Corporation. All rights reserved.
> + (C) Copyright 2020 Hewlett Packard Enterprise Development LP
> + > + SPDX-License-Identifier: BSD-2-Clause-Patent > + > +**/ > + > +#ifndef CRT_STDLIB_H_ > +#define CRT_STDLIB_H_ > + > +#include > + > +#endif > diff --git a/RedfishPkg/Library/JsonLib/string.h > b/RedfishPkg/Library/JsonLib/string.h > new file mode 100644 > index 0000000000..f60b87ccd2 > --- /dev/null > +++ b/RedfishPkg/Library/JsonLib/string.h > @@ -0,0 +1,16 @@ > +/** @file > + Include file to support building the third-party jansson library. > + > + Copyright (c) 2019, Intel Corporation. All rights reserved.
> + (C) Copyright 2020 Hewlett Packard Enterprise Development LP
> + > + SPDX-License-Identifier: BSD-2-Clause-Patent > + > +**/ > + > +#ifndef CRT_STRING_H_ > +#define CRT_STRING_H_ > + > +#include > + > +#endif > diff --git a/RedfishPkg/Library/JsonLib/sys/time.h > b/RedfishPkg/Library/JsonLib/sys/time.h > new file mode 100644 > index 0000000000..4ced176cda > --- /dev/null > +++ b/RedfishPkg/Library/JsonLib/sys/time.h > @@ -0,0 +1,15 @@ > +/** @file > + Include file to support building the third-party jansson library. > + > + Copyright (c) 2019, Intel Corporation. All rights reserved.
> + (C) Copyright 2020 Hewlett Packard Enterprise Development LP
> + > + SPDX-License-Identifier: BSD-2-Clause-Patent > + > +**/ > +#ifndef CRT_SYS_TIME_H_ > +#define CRT_SYS_TIME_H_ > + > +#include > + > +#endif > diff --git a/RedfishPkg/Library/JsonLib/sys/types.h > b/RedfishPkg/Library/JsonLib/sys/types.h > new file mode 100644 > index 0000000000..c4f807214c > --- /dev/null > +++ b/RedfishPkg/Library/JsonLib/sys/types.h > @@ -0,0 +1,15 @@ > +/** @file > + Include file to support building the third-party jansson library. > + > + Copyright (c) 2019, Intel Corporation. All rights reserved.
> + (C) Copyright 2020 Hewlett Packard Enterprise Development LP
> + > + SPDX-License-Identifier: BSD-2-Clause-Patent > + > +**/ > +#ifndef CRT_SYS_TYPES_H_ > +#define CRT_SYS_TYPES_H_ > + > +#include > + > +#endif > diff --git a/RedfishPkg/Library/JsonLib/time.h > b/RedfishPkg/Library/JsonLib/time.h > new file mode 100644 > index 0000000000..ca04ac8730 > --- /dev/null > +++ b/RedfishPkg/Library/JsonLib/time.h > @@ -0,0 +1,15 @@ > +/** @file > + Include file to support building the third-party jansson library. > + > + Copyright (c) 2019, Intel Corporation. All rights reserved.
> + (C) Copyright 2020 Hewlett Packard Enterprise Development LP
> + > + SPDX-License-Identifier: BSD-2-Clause-Patent > + > +**/ > +#ifndef CRT_TIME_H_ > +#define CRT_TIME_H_ > + > +#include > + > +#endif > diff --git a/RedfishPkg/RedfishPkg.ci.yaml b/RedfishPkg/RedfishPkg.ci.yaml > index 20c297ad22..2c7b4d5862 100644 > --- a/RedfishPkg/RedfishPkg.ci.yaml > +++ b/RedfishPkg/RedfishPkg.ci.yaml > @@ -17,6 +17,39 @@ > ], > ## Both file path and directory path are accepted. > "IgnoreFiles": [ > + ## Below are files incorporated with open source which are > + ## not edk2 coding standard compliant. > + ## > + ## For jansson library open source > + ## load.c is overrided from open source. > + "Library/JsonLib/load.c", > + ## C runtime library for EDKII JsonLib. > + "Library/JsonLib/sys", > + "Library/JsonLib/assert.h", > + "Library/JsonLib/errno.h", > + "Library/JsonLib/jansson_config.h", > + "Library/JsonLib/jansson_private_config.h", > + "Library/JsonLib/limits.h", > + "Library/JsonLib/math.h", > + "Library/JsonLib/stdarg.h", > + "Library/JsonLib/stddef.h", > + "Library/JsonLib/stdio.h", > + "Library/JsonLib/stdlib.h", > + "Library/JsonLib/string.h", > + "Library/JsonLib/time.h", > + ## > + ## EDK2 CRT library which is not edk2 coding > + ## standard compliant. > + "Include/Library/CrtLib.h", > + "Library/CrtLib/CrtLib.c", > + ## > + ## Below header file is used by open source > + ## project which uses jansson library. Use this > + ## header file to map jansson native APIs to > + ## edk2 JsonLib APIs.This header file doesn't > + ## have the corresponding library class. This > + ## header file is not edk2 codingstandard compliant. > + "Include/JanssonJsonMapping.h" > ] > }, > "CompilerPlugin": { > -- > 2.17.1