From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from NAM12-MW2-obe.outbound.protection.outlook.com (NAM12-MW2-obe.outbound.protection.outlook.com [40.107.244.40]) by mx.groups.io with SMTP id smtpd.web10.883.1682131546360076028 for ; Fri, 21 Apr 2023 19:45:46 -0700 Authentication-Results: mx.groups.io; dkim=fail reason="body hash did not verify" header.i=@nvidia.com header.s=selector2 header.b=ahFytRlA; spf=permerror, err=parse error for token &{10 18 %{i}._ip.%{h}._ehlo.%{d}._spf.vali.email}: invalid domain name (domain: nvidia.com, ip: 40.107.244.40, mailfrom: nicklew@nvidia.com) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=G2LR9DbS5/G18vTgYPxFA16oy7YDZvbL8SXy166ABiU1VtMToczaK+fXvIx85IBPTLnZx4KpVvILFtdX6Ll0WjCnB5jdUH/pDqf8UGAj/pZhtbbYaN+uZoBYge9G/b+X95uAS5cbfZiWB/aq7k5rLvyubBq0Mu1r9KTzN738jei3AcW1PE2jNVQgpddHQIhBlQ2odTHu0mE7FUKNppvoFRlE2Bs3lsCR+eHhqdRzQt4YDwM1fvn555LFzEbVxqRs4Mmg1q1uav6NvvJ7XalUiddGQ1giWpgFCQb48ZlC3RXyiBE943mPXiOA8Vn1RomvVAErlZZfJS6AUc6m9CPqmg== 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-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=gNgj0JT64lJY9tYK972a2J2FN51W4gPz8J5UJ1P6D2I=; b=jeiFIj1VbzaMkzDb8r/I/Jk0b/Lw0GJft9YlJn04FT5sRs0wei46OsZmUVqaH9UYkAQNqyG9HGeMpBHR5kN7Oty1iKrBH9iI4tCfL+yYnNDAt4/iYy6nNst+qe2uvoo1l4BYqFT1lyeyvLztayql81qTq+cZETAhvkbhMz+SRmnN29WDC2RCFIf9E07a1Fav2gmhIi/l6ESzJ5e3jlCjugjE10dcpRVbjJNu9+RmMGyU7gaGuQnF5IWgJSobzXDpjWhTLgTjVe27vG/MOAGfOjWSh71/fywedLymxwOFVvrA1yAuWKf8gRTNc8HSVV8dy1kQskF8PbZDl4+jU8cIBw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 216.228.117.160) smtp.rcpttodomain=edk2.groups.io smtp.mailfrom=nvidia.com; dmarc=pass (p=reject sp=reject pct=100) action=none header.from=nvidia.com; dkim=none (message not signed); arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Nvidia.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=gNgj0JT64lJY9tYK972a2J2FN51W4gPz8J5UJ1P6D2I=; b=ahFytRlAzSrONaJKrlayeSY8osvNweTupEsJI2JVyZfj/Yl+5UAwRadH0PxlGXdDG+H4W6ub5gB8zkrGneBz8N/L6J+v+4cMUZphnRzZ4l5xQzVklgXS7pFVIxl377UMAx1Svo3WIlqFwZJ6muBwWiepdgZwpE6AaP7GDEO5/gIZNCveufRnw6GU4YMB9GI6jv2CLc/MVu1JrcOzK3v4i8ypO56WPbahWnyVbGFD4VlqVEhI0To4Blnmaa3bX4kuXXwL+qCzF0JnXTkAFY6SPMbF8O3PwYrqLqE3Bi1gnnEpXU5l0ndS00xZw1SIo3gm9MV0AYKL+cwoEJF0f/91wA== Received: from BN8PR16CA0011.namprd16.prod.outlook.com (2603:10b6:408:4c::24) by BL1PR12MB5351.namprd12.prod.outlook.com (2603:10b6:208:317::16) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6319.22; Sat, 22 Apr 2023 02:45:43 +0000 Received: from BN8NAM11FT083.eop-nam11.prod.protection.outlook.com (2603:10b6:408:4c:cafe::22) by BN8PR16CA0011.outlook.office365.com (2603:10b6:408:4c::24) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6319.25 via Frontend Transport; Sat, 22 Apr 2023 02:45:43 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 216.228.117.160) smtp.mailfrom=nvidia.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=nvidia.com; Received-SPF: Pass (protection.outlook.com: domain of nvidia.com designates 216.228.117.160 as permitted sender) receiver=protection.outlook.com; client-ip=216.228.117.160; helo=mail.nvidia.com; pr=C Received: from mail.nvidia.com (216.228.117.160) by BN8NAM11FT083.mail.protection.outlook.com (10.13.177.75) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6340.15 via Frontend Transport; Sat, 22 Apr 2023 02:45:43 +0000 Received: from rnnvmail204.nvidia.com (10.129.68.6) by mail.nvidia.com (10.129.200.66) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.5; Fri, 21 Apr 2023 19:45:31 -0700 Received: from rnnvmail204.nvidia.com (10.129.68.6) by rnnvmail204.nvidia.com (10.129.68.6) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.37; Fri, 21 Apr 2023 19:45:31 -0700 Received: from NV-CL38DL3.nvidia.com (10.127.8.12) by mail.nvidia.com (10.129.68.6) with Microsoft SMTP Server id 15.2.986.37 via Frontend Transport; Fri, 21 Apr 2023 19:45:30 -0700 From: "Nickle Wang" To: CC: Abner Chang , Igor Kulchytskyy , Michael D Kinney Subject: [edk2-redfish-client][PATCH v2] Initial edk2 redfish client repository Date: Sat, 22 Apr 2023 10:45:25 +0800 Message-ID: <20230422024525.1266-1-nicklew@nvidia.com> X-Mailer: git-send-email 2.17.1 MIME-Version: 1.0 Return-Path: nicklew@nvidia.com X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: BN8NAM11FT083:EE_|BL1PR12MB5351:EE_ X-MS-Office365-Filtering-Correlation-Id: 1f62da74-fa17-43ae-2e40-08db42dbab06 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: z9Crto1NK7ivPyS0gsxDsuky6pVZY7vzPJfDBpx9VBg2FOvzMfRu+hIdFFg0SRbqpQaMWknnwVEo7dYKo1x9l9Jx7eOMq2jahEabV7iT9nwHjWbiRv39AWj1C42jb3W7AiwJV6iMUVkOX+qr1Q/tFwf6vqa/QN2wwzrWPlS8oEMednk2EL2XPC0/kXFBWOV53qxZ7129BF5wXONf40y0tXWaEoPwVadjh3RMcz29xtMwv++uULIAU0PMXY2wReWUxH63zLWhqrDsC6D2SMRGUnZ0ixpHakjX9rMg0nzlxnAZttRWbWM0ieWXY4tT46vFCyrdiAsFdkq+vZvaSQKhcK+vJbwHKaqWE5niGlRgeJm4pFgSQ++xMNOmYUtUavMiS6F3dGrI/2HkY9FgRQphVnE5bVCoNFQxHfmBhWVkOhOMEIv3b9gw8L0xFod4PJ8ZdpT/9vriHxXx7MOgfyTnSF05MTypjCsPXovuttBQMUSOrw/lkB1heVHJfF5PlE7Ysews/MLqwQoMY3evmaHrWwCesXJIZB4HGBeRLiYiGEBkH7u5mjpEdPvjzcoPIMUTWgntGDcV0N3xoAGD/RFsBc0hPe3bSIMv/Qx03hZ3Cxldc2evnnE9gZua1ECf1vSxo6Meo9U18ETz+Ra3PZMBJdjLO5KKYSmAEfCXQDhWj57PnUpq1wBu/XiiJje2h3RlXY/04DWWpd2B3b1I0CU7mNo8lmEsMttnw0I3gCO3h4l/oJwD83ruB3kpureAofvuvpol/WzcEpcHr/90dmwG4tw/qij1MslYbhJ0mRotQmlCOOaeI5u3+r4UjwAKm9z28Au++OTbiO0ttH8QBVh9EH/J1SQVZfFZ3kUQTz6moFs= X-Forefront-Antispam-Report: CIP:216.228.117.160;CTRY:US;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:mail.nvidia.com;PTR:dc6edge1.nvidia.com;CAT:NONE;SFS:(13230028)(4636009)(396003)(136003)(346002)(39860400002)(376002)(451199021)(46966006)(36840700001)(40470700004)(34020700004)(54906003)(36860700001)(478600001)(83380400001)(7696005)(2616005)(40480700001)(47076005)(966005)(1076003)(26005)(6666004)(70206006)(70586007)(356005)(7636003)(316002)(82740400003)(36756003)(426003)(336012)(6916009)(4326008)(186003)(5660300002)(41300700001)(40460700003)(66899021)(8676002)(2906002)(8936002)(86362001)(82310400005);DIR:OUT;SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 22 Apr 2023 02:45:43.5606 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 1f62da74-fa17-43ae-2e40-08db42dbab06 X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a;Ip=[216.228.117.160];Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: BN8NAM11FT083.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: BL1PR12MB5351 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain Add required files to initial edk2 redfish client repository. Signed-off-by: Nickle Wang Cc: Abner Chang Cc: Igor Kulchytskyy Cc: Michael D Kinney --- .gitignore | 6 +++++ CONTRIBUTING.md | 3 +++ LICENSE | 51 ++++++++++++++++++++++++++++++++++++++ Maintainers.txt | 48 +++++++++++++++++++++++++++++++++++ README.md | 66 +++++++++++++++++++++++++++++++++++++++++++++++++ 5 files changed, 174 insertions(+) create mode 100644 .gitignore create mode 100644 CONTRIBUTING.md create mode 100644 LICENSE create mode 100644 Maintainers.txt create mode 100644 README.md diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..df38443 --- /dev/null +++ b/.gitignore @@ -0,0 +1,6 @@ +.DS_Store +*_extdep/ +*.pyc +__pycache__/ +tags/ +.vscode/ diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..39a1732 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,3 @@ +# Contributing to EDK Redfish Client + +Contributor documentation is maintained on the wiki: https://github.com/ti= anocore/tianocore.github.io/wiki/EDK-II-Development-Process diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..ee84050 --- /dev/null +++ b/LICENSE @@ -0,0 +1,51 @@ +Copyright (c) 2019, TianoCore and contributors. All rights reserved. + +SPDX-License-Identifier: BSD-2-Clause-Patent + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met= : + +1. Redistributions of source code must retain the above copyright notice, + this list of conditions and the following disclaimer. + +2. Redistributions in binary form must reproduce the above copyright notic= e, + this list of conditions and the following disclaimer in the documentati= on + and/or other materials provided with the distribution. + +Subject to the terms and conditions of this license, each copyright holder +and contributor hereby grants to those receiving rights under this license +a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocabl= e +(except for failure to satisfy the conditions of this license) patent +license to make, have made, use, offer to sell, sell, import, and otherwis= e +transfer this software, where such license applies only to those patent +claims, already acquired or hereafter acquired, licensable by such copyrig= ht +holder or contributor that are necessarily infringed by: + +(a) their Contribution(s) (the licensed copyrights of copyright holders an= d + non-copyrightable additions of contributors, in source or binary form) + alone; or + +(b) combination of their Contribution(s) with the work of authorship to + which such Contribution(s) was added by such copyright holder or + contributor, if, at the time the Contribution is added, such addition + causes such combination to be necessarily infringed. The patent licens= e + shall not apply to any other combinations which include the + Contribution. + +Except as expressly stated above, no rights or licenses from any copyright +holder or contributor is granted under this license, whether expressly, by +implication, estoppel or otherwise. + +DISCLAIMER + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS= " +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE +LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +POSSIBILITY OF SUCH DAMAGE. diff --git a/Maintainers.txt b/Maintainers.txt new file mode 100644 index 0000000..88fd03a --- /dev/null +++ b/Maintainers.txt @@ -0,0 +1,48 @@ +EDK Redfish Client Maintainers +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +This file provides information about the primary maintainers for +EDK Redfish Client. + +In general, you should not privately email the maintainer. You should +email the edk2-devel list, and Cc the package maintainers and +reviewers. + +If the package maintainer wants to hand over the role to other people, +the package maintainer should send the patch to update Maintainers.txt +with new maintainer, and the new maintainer should follow up with +an Acked-by or a Reviewed-by. + +Descriptions of section entries: + + L: Mailing list that is relevant to this area (default is edk2-devel) + Patches and questions should be sent to the email list. + M: Package Maintainer: Cc address for patches and questions. Responsible + for reviewing and pushing package changes to source control. + R: Package Reviewer: Cc address for patches and questions. Reviewers hel= p + maintainers review code, but don't have push access. A designated Pac= kage + Reviewer is reasonably familiar with the Package (or some modules + thereof), and/or provides testing or regression testing for the Packa= ge + (or some modules thereof), in certain platforms and environments. + F: Files and directories with wildcard patterns. + A trailing slash includes all files and subdirectory files. + F: MdeModulePkg/ all files in and below MdeModulePkg + F: MdeModulePkg/* all files in MdeModulePkg, but not below + F: */Pci/* all files in a directory called Pci, at any dept= h in + the hierarchy, but not below + One pattern per line. Multiple F: lines per section acceptable. + + Filenames not caught by any F: rule get matched as being located in the = top- + level directory. (Internally, the script looks for a match called '', + so please don't add a file called that in the top-level directory.) + +EDK Redfish Client +------ +L: https://edk2.groups.io/g/devel/ +T: git - https://github.com/tianocore/edk2-redfish-client.git + +RedfishClientPkg: Redfish client related modules +F: RedfishClientPkg/ +M: Abner Chang [changab] +M: Nickle Wang [nicklela] +R: Igor Kulchytskyy [igorkulchytskyy] diff --git a/README.md b/README.md new file mode 100644 index 0000000..4dfa2c6 --- /dev/null +++ b/README.md @@ -0,0 +1,66 @@ +# Tianocore Redfish Client +This repository holds EDKII Redfish client libraries, drivers and applicat= ions. +EDKII Redfish client work with EDKII [RedfishPkg](https://github.com/tiano= core/edk2/tree/master/RedfishPkg), +and provides the functionality to support Redfish service hosted by Board = Management Controller (BMC) in server. +Please check [Readme.md](https://github.com/tianocore/edk2/blob/master/Red= fishPkg/Readme.md) for the design of +UEFI Redfish EDK2 implementation. + +# License +The majority of the content in the EDK Redfish Client open source project = uses a +[BSD-2-Clause Plus Patent License](LICENSE). + +# Maintainers + +See [Maintainers.txt](Maintainers.txt). + +# Contributing + +The patch review process would be the same as edk2, and adding prefix **[e= dk2-redfish-client]** +specifically for the patches against edk2-redfish-client repository. For m= ore details, please +see [CONTRIBUTING.md](CONTRIBUTING.md). + +# How to build (Ubuntu Environment) +## Prerequisite +### Install packages +``` +apt-get update; apt-get install install gcc g++ make uuid-dev nasm +``` +If the `nasm` installed above shows build error during build process, we n= eed to install +newer version of `nasm` manually: +- Download `nasm` + ``` + wget https://www.nasm.us/pub/nasm/releasebuilds/2.15rc12/nasm-2.15rc12.t= ar.gz" + ``` +- Extract file + ``` + tar zxvf nasm-2.15rc12.tar.gz" + ``` +- Build and install `nasm` + ``` + cd nasm-2.15rc12 + ./configure --prefix=3D/usr + sudo make install + ``` +- Check to see if `nasm` reports desired version or not + ``` + nasm -v + ``` +### Build EDKII base tools +- Initial submodule (skip this if you already did this) + ``` + git submodule update --init + ``` +- Build base tools + ``` + cd BaseTools + make + ``` +## Build RedfishClientPkg +In order to reference RedfishClientPkg, we need to set `PACKAGES_PATH` and= specify the location +of edk2-redfish-client repository. +``` +export PACKAGES_PATH=3D$PWD/edk2:$PWD/edk2-redfish-client +cd $PWD/edk2 +. ./edksetup.sh +build -p RedfishClientPkg/RedfishClientPkg.dsc -t GCC5 -a X64 +``` --=20 2.17.1