From nobody Sun May 19 14:33:00 2024 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.108 as permitted sender) smtp.mailfrom=bounce+27952+103436+1787277+3901457@groups.io; arc=fail (BodyHash is different from the expected one) Received: from mail02.groups.io (mail02.groups.io [66.175.222.108]) by mx.zohomail.com with SMTPS id 1682131547577748.4839959749045; Fri, 21 Apr 2023 19:45:47 -0700 (PDT) Return-Path: X-Received: by 127.0.0.2 with SMTP id 5tXaYY1788612xSfKaos01Wt; Fri, 21 Apr 2023 19:45:47 -0700 X-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 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 X-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 X-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 (zohomail.com: domain of groups.io designates 66.175.222.108 as permitted sender) client-ip=66.175.222.108; envelope-from=bounce+27952+103436+1787277+3901457@groups.io; helo=mail02.groups.io; 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 X-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 X-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 X-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 X-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 via groups.io" To: CC: Abner Chang , Igor Kulchytskyy , Michael D Kinney Subject: [edk2-devel] [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> MIME-Version: 1.0 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-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-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 Precedence: Bulk List-Unsubscribe: List-Subscribe: List-Help: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,nicklew@nvidia.com X-Gm-Message-State: 9GRwTa1p57NEJmbfkVjsXFQ2x1787277AA= Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1682131547; bh=cejTY4LDXc1prSWWE6JE7od9ezHJlb6XeS08WKHpxJ0=; h=CC:Content-Type:Date:From:Reply-To:Subject:To; b=wxBdG/nxnzlesziQernka69y850dCOFhQv7ujJ6XI+P00oX7466Q3xJ+D1Iq7VIoGBR 85q5NLI/D4m5ahBsSJOgQRNKB0kjkt6C39aMfXjEDAzPrc+vC88HFIMuxrUN+TNaZ3zBL AB/p7EL/i7d5PVTRw8ije+YprStoLTYk32w= X-ZohoMail-DKIM: pass (identity @groups.io) X-ZM-MESSAGEID: 1682131549404100001 Content-Type: text/plain; charset="utf-8" Add required files to initial edk2 redfish client repository. Signed-off-by: Nickle Wang Cc: Abner Chang Cc: Igor Kulchytskyy Cc: Michael D Kinney Reviewed-by: Abner Chang Reviewed-by: Igor Kulchytskyy --- .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, irrevocable +(except for failure to satisfy the conditions of this license) patent +license to make, have made, use, offer to sell, sell, import, and otherwise +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 and + 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 license + 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 help + 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 -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#103436): https://edk2.groups.io/g/devel/message/103436 Mute This Topic: https://groups.io/mt/98427967/1787277 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [importer@patchew.org] -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-