<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:dt="uuid:C2F41010-65B3-11d1-A29F-00AA00C14882" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta name="ProgId" content="Word.Document"> <meta name="Generator" content="Microsoft Word 15"> <meta name="Originator" content="Microsoft Word 15"> <link rel="File-List" href="cid:filelist.xml@01D9742C.84AB1D50"><style></style> </head> <body lang="EN-US" link="#0563C1" vlink="#954F72" style="tab-interval:.5in;word-wrap:break-word"> <div class="WordSection1"> If no modifications were made, you should leave the copyright statement alone.<o:p></o:p> <o:p> </o:p> Mike<o:p></o:p> <o:p> </o:p> <div style="border:none;border-left:solid blue 1.5pt;padding:0in 0in 0in 4.0pt"> <div> <div style="border:none;border-top:solid #E1E1E1 1.0pt;padding:3.0pt 0in 0in 0in"> From: Nickle Wang <nicklew@nvidia.com> Sent: Thursday, April 20, 2023 8:32 PM To: devel@edk2.groups.io; Nickle Wang <nicklew@nvidia.com>; Kinney, Michael D <michael.d.kinney@intel.com> Cc: Abner Chang <abner.chang@amd.com>; Igor Kulchytskyy <igork@ami.com> Subject: RE: [edk2-devel] [edk2-redfish-client][PATCH] Initial edk2 redfish client repository<o:p></o:p> </div> </div> <o:p> </o:p> Hi <a id="OWAAM4FF6AAC89E9742A08F8A8E407ADCFBCC" href="mailto:michael.d.kinney@intel.com"> @Michael D Kinney</a>,<o:p></o:p> <o:p> </o:p> May I have your comment to my copyright year question? <o:p> </o:p> <o:p> </o:p> The copyright year in LICENSE file that I use is 2021 because the earliest file in RedfishClientPkg from edk2-staging is created in 2021. But since this repository is created in 2023, do you know what copyright year that I should use?<o:p></o:p> <o:p> </o:p> > Copyright (c) 2021, TianoCore and contributors. All rights reserved.<o:p></o:p> <o:p> </o:p> Thanks,<o:p></o:p> Nickle<o:p></o:p> <o:p> </o:p> > -----Original Message-----<o:p></o:p> > From: <a href="mailto:devel@edk2.groups.io"> devel@edk2.groups.io</a> <<a href="mailto:devel@edk2.groups.io">devel@edk2.groups.io</a>> On Behalf Of Nickle<o:p></o:p> > Wang via groups.io<o:p></o:p> > Sent: Friday, April 21, 2023 11:26 AM<o:p></o:p> > To: <a href="mailto:devel@edk2.groups.io">devel@edk2.groups.io</a><o:p></o:p> > Cc: Abner Chang <<a href="mailto:abner.chang@amd.com">abner.chang@amd.com</a>>; Igor Kulchytskyy <<a href="mailto:igork@ami.com">igork@ami.com</a>>;<o:p></o:p> > Michael D Kinney <<a href="mailto:michael.d.kinney@intel.com">michael.d.kinney@intel.com</a>><o:p></o:p> > Subject: [edk2-devel] [edk2-redfish-client][PATCH] Initial edk2 redfish client<o:p></o:p> > repository<o:p></o:p> > <o:p></o:p> > External email: Use caution opening links or attachments<o:p></o:p> > <o:p></o:p> > <o:p></o:p> > Add required files to initial edk2 redfish client repository.<o:p></o:p> > <o:p></o:p> > Signed-off-by: Nickle Wang <<a href="mailto:nicklew@nvidia.com">nicklew@nvidia.com</a>><o:p></o:p> > Cc: Abner Chang <<a href="mailto:abner.chang@amd.com">abner.chang@amd.com</a>><o:p></o:p> > Cc: Igor Kulchytskyy <<a href="mailto:igork@ami.com">igork@ami.com</a>><o:p></o:p> > Cc: Michael D Kinney <<a href="mailto:michael.d.kinney@intel.com">michael.d.kinney@intel.com</a>><o:p></o:p> > ---<o:p></o:p> > .gitignore | 6 +++++<o:p></o:p> > CONTRIBUTING.md | 3 +++<o:p></o:p> > LICENSE | 51 ++++++++++++++++++++++++++++++++++++++<o:p></o:p> > Maintainers.txt | 48 +++++++++++++++++++++++++++++++++++<o:p></o:p> > README.md | 66<o:p></o:p> > +++++++++++++++++++++++++++++++++++++++++++++++++<o:p></o:p> > 5 files changed, 174 insertions(+)<o:p></o:p> > create mode 100644 .gitignore<o:p></o:p> > create mode 100644 CONTRIBUTING.md<o:p></o:p> > create mode 100644 LICENSE<o:p></o:p> > create mode 100644 Maintainers.txt<o:p></o:p> > create mode 100644 README.md<o:p></o:p> > <o:p></o:p> > diff --git a/.gitignore b/.gitignore<o:p></o:p> > new file mode 100644<o:p></o:p> > index 0000000..df38443<o:p></o:p> > --- /dev/null<o:p></o:p> > +++ b/.gitignore<o:p></o:p> > @@ -0,0 +1,6 @@<o:p></o:p> > +.DS_Store<o:p></o:p> > +*_extdep/<o:p></o:p> > +*.pyc<o:p></o:p> > +__pycache__/<o:p></o:p> > +tags/<o:p></o:p> > +.vscode/<o:p></o:p> > diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644<o:p></o:p> > index 0000000..39a1732<o:p></o:p> > --- /dev/null<o:p></o:p> > +++ b/CONTRIBUTING.md<o:p></o:p> > @@ -0,0 +1,3 @@<o:p></o:p> > +# Contributing to EDK Redfish Client<o:p></o:p> > +<o:p></o:p> > +Contributor documentation is maintained on the wiki:<o:p></o:p> > +https://github.com/tianocore/tianocore.github.io/wiki/EDK-II-Developmen<o:p></o:p> > +t-Process<o:p></o:p> > diff --git a/LICENSE b/LICENSE<o:p></o:p> > new file mode 100644<o:p></o:p> > index 0000000..fd0e199<o:p></o:p> > --- /dev/null<o:p></o:p> > +++ b/LICENSE<o:p></o:p> > @@ -0,0 +1,51 @@<o:p></o:p> > +Copyright (c) 2021, TianoCore and contributors. All rights reserved.<o:p></o:p> > +<o:p></o:p> > +SPDX-License-Identifier: BSD-2-Clause-Patent<o:p></o:p> > +<o:p></o:p> > +Redistribution and use in source and binary forms, with or without<o:p></o:p> > +modification, are permitted provided that the following conditions are met:<o:p></o:p> > +<o:p></o:p> > +1. Redistributions of source code must retain the above copyright notice,<o:p></o:p> > + this list of conditions and the following disclaimer.<o:p></o:p> > +<o:p></o:p> > +2. Redistributions in binary form must reproduce the above copyright notice,<o:p></o:p> > + this list of conditions and the following disclaimer in the documentation<o:p></o:p> > + and/or other materials provided with the distribution.<o:p></o:p> > +<o:p></o:p> > +Subject to the terms and conditions of this license, each copyright<o:p></o:p> > +holder and contributor hereby grants to those receiving rights under<o:p></o:p> > +this license a perpetual, worldwide, non-exclusive, no-charge,<o:p></o:p> > +royalty-free, irrevocable (except for failure to satisfy the conditions<o:p></o:p> > +of this license) patent license to make, have made, use, offer to sell,<o:p></o:p> > +sell, import, and otherwise transfer this software, where such license<o:p></o:p> > +applies only to those patent claims, already acquired or hereafter<o:p></o:p> > +acquired, licensable by such copyright holder or contributor that are necessarily<o:p></o:p> > infringed by:<o:p></o:p> > +<o:p></o:p> > +(a) their Contribution(s) (the licensed copyrights of copyright holders and<o:p></o:p> > + non-copyrightable additions of contributors, in source or binary form)<o:p></o:p> > + alone; or<o:p></o:p> > +<o:p></o:p> > +(b) combination of their Contribution(s) with the work of authorship to<o:p></o:p> > + which such Contribution(s) was added by such copyright holder or<o:p></o:p> > + contributor, if, at the time the Contribution is added, such addition<o:p></o:p> > + causes such combination to be necessarily infringed. The patent license<o:p></o:p> > + shall not apply to any other combinations which include the<o:p></o:p> > + Contribution.<o:p></o:p> > +<o:p></o:p> > +Except as expressly stated above, no rights or licenses from any<o:p></o:p> > +copyright holder or contributor is granted under this license, whether<o:p></o:p> > +expressly, by implication, estoppel or otherwise.<o:p></o:p> > +<o:p></o:p> > +DISCLAIMER<o:p></o:p> > +<o:p></o:p> > +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND<o:p></o:p> > CONTRIBUTORS "AS IS"<o:p></o:p> > +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED<o:p></o:p> > TO,<o:p></o:p> > +THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A<o:p></o:p> > PARTICULAR<o:p></o:p> > +PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR<o:p></o:p> > +CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,<o:p></o:p> > +EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED<o:p></o:p> > TO,<o:p></o:p> > +PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR<o:p></o:p> > +PROFITS; OR BUSINESS<o:p></o:p> > +INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,<o:p></o:p> > WHETHER IN<o:p></o:p> > +CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR<o:p></o:p> > OTHERWISE)<o:p></o:p> > +ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED<o:p></o:p> > OF<o:p></o:p> > +THE POSSIBILITY OF SUCH DAMAGE.<o:p></o:p> > diff --git a/Maintainers.txt b/Maintainers.txt new file mode 100644 index<o:p></o:p> > 0000000..88fd03a<o:p></o:p> > --- /dev/null<o:p></o:p> > +++ b/Maintainers.txt<o:p></o:p> > @@ -0,0 +1,48 @@<o:p></o:p> > +EDK Redfish Client Maintainers<o:p></o:p> > +==================<o:p></o:p> > +<o:p></o:p> > +This file provides information about the primary maintainers for EDK<o:p></o:p> > +Redfish Client.<o:p></o:p> > +<o:p></o:p> > +In general, you should not privately email the maintainer. You should<o:p></o:p> > +email the edk2-devel list, and Cc the package maintainers and<o:p></o:p> > +reviewers.<o:p></o:p> > +<o:p></o:p> > +If the package maintainer wants to hand over the role to other people,<o:p></o:p> > +the package maintainer should send the patch to update Maintainers.txt<o:p></o:p> > +with new maintainer, and the new maintainer should follow up with an<o:p></o:p> > +Acked-by or a Reviewed-by.<o:p></o:p> > +<o:p></o:p> > +Descriptions of section entries:<o:p></o:p> > +<o:p></o:p> > + L: Mailing list that is relevant to this area (default is edk2-devel)<o:p></o:p> > + Patches and questions should be sent to the email list.<o:p></o:p> > + M: Package Maintainer: Cc address for patches and questions. Responsible<o:p></o:p> > + for reviewing and pushing package changes to source control.<o:p></o:p> > + R: Package Reviewer: Cc address for patches and questions. Reviewers help<o:p></o:p> > + maintainers review code, but don't have push access. A designated Package<o:p></o:p> > + Reviewer is reasonably familiar with the Package (or some modules<o:p></o:p> > + thereof), and/or provides testing or regression testing for the Package<o:p></o:p> > + (or some modules thereof), in certain platforms and environments.<o:p></o:p> > + F: Files and directories with wildcard patterns.<o:p></o:p> > + A trailing slash includes all files and subdirectory files.<o:p></o:p> > + F: MdeModulePkg/ all files in and below MdeModulePkg<o:p></o:p> > + F: MdeModulePkg/* all files in MdeModulePkg, but not below<o:p></o:p> > + F: */Pci/* all files in a directory called Pci, at any depth in<o:p></o:p> > + the hierarchy, but not below<o:p></o:p> > + One pattern per line. Multiple F: lines per section acceptable.<o:p></o:p> > +<o:p></o:p> > + Filenames not caught by any F: rule get matched as being located in<o:p></o:p> > + the top- level directory. (Internally, the script looks for a match<o:p></o:p> > + called '<default>', so please don't add a file called that in the<o:p></o:p> > + top-level directory.)<o:p></o:p> > +<o:p></o:p> > +EDK Redfish Client<o:p></o:p> > +------<o:p></o:p> > +L: <a href="https://edk2.groups.io/g/devel/">https://edk2.groups.io/g/devel/</a><o:p></o:p> > +T: git - <a href="https://github.com/tianocore/edk2-redfish-client.git"> https://github.com/tianocore/edk2-redfish-client.git</a><o:p></o:p> > +<o:p></o:p> > +RedfishClientPkg: Redfish client related modules<o:p></o:p> > +F: RedfishClientPkg/<o:p></o:p> > +M: Abner Chang <<a href="mailto:abner.chang@amd.com">abner.chang@amd.com</a>> [changab]<o:p></o:p> > +M: Nickle Wang <<a href="mailto:nicklew@nvidia.com">nicklew@nvidia.com</a>> [nicklela]<o:p></o:p> > +R: Igor Kulchytskyy <<a href="mailto:igork@ami.com">igork@ami.com</a>> [igorkulchytskyy]<o:p></o:p> > diff --git a/README.md b/README.md<o:p></o:p> > new file mode 100644<o:p></o:p> > index 0000000..4dfa2c6<o:p></o:p> > --- /dev/null<o:p></o:p> > +++ b/README.md<o:p></o:p> > @@ -0,0 +1,66 @@<o:p></o:p> > +# Tianocore Redfish Client<o:p></o:p> > +This repository holds EDKII Redfish client libraries, drivers and applications.<o:p></o:p> > +EDKII Redfish client work with EDKII<o:p></o:p> > +[RedfishPkg](<a href="https://github.com/tianocore/edk2/tree/master/RedfishPkg">https://github.com/tianocore/edk2/tree/master/RedfishPkg</a>),<o:p></o:p> > +and provides the functionality to support Redfish service hosted by Board<o:p></o:p> > Management Controller (BMC) in server.<o:p></o:p> > +Please check<o:p></o:p> > +[Readme.md](<a href="https://github.com/tianocore/edk2/blob/master/RedfishPkg/Readme.md">https://github.com/tianocore/edk2/blob/master/RedfishPkg/Re</a><o:p></o:p> <a href="https://github.com/tianocore/edk2/blob/master/RedfishPkg/Readme.md">> adme.md</a>) for the design of UEFI Redfish EDK2 implementation.<o:p></o:p> > +<o:p></o:p> > +# License<o:p></o:p> > +The majority of the content in the EDK Redfish Client open source<o:p></o:p> > +project uses a [BSD-2-Clause Plus Patent License](LICENSE).<o:p></o:p> > +<o:p></o:p> > +# Maintainers<o:p></o:p> > +<o:p></o:p> > +See [Maintainers.txt](Maintainers.txt).<o:p></o:p> > +<o:p></o:p> > +# Contributing<o:p></o:p> > +<o:p></o:p> > +The patch review process would be the same as edk2, and adding prefix<o:p></o:p> > +**[edk2-redfish-client]** specifically for the patches against<o:p></o:p> > +edk2-redfish-client repository. For more details, please see<o:p></o:p> > [CONTRIBUTING.md](CONTRIBUTING.md).<o:p></o:p> > +<o:p></o:p> > +# How to build (Ubuntu Environment)<o:p></o:p> > +## Prerequisite<o:p></o:p> > +### Install packages<o:p></o:p> > +```<o:p></o:p> > +apt-get update; apt-get install install gcc g++ make uuid-dev nasm ```<o:p></o:p> > +If the `nasm` installed above shows build error during build process,<o:p></o:p> > +we need to install newer version of `nasm` manually:<o:p></o:p> > +- Download `nasm`<o:p></o:p> > + ```<o:p></o:p> > + wget <a href="https://www.nasm.us/pub/nasm/releasebuilds/2.15rc12/nasm-2.15rc12.tar.gz"> https://www.nasm.us/pub/nasm/releasebuilds/2.15rc12/nasm-</a><o:p></o:p> <a href="https://www.nasm.us/pub/nasm/releasebuilds/2.15rc12/nasm-2.15rc12.tar.gz">> 2.15rc12.tar.gz</a>"<o:p></o:p> > + ```<o:p></o:p> > +- Extract file<o:p></o:p> > + ```<o:p></o:p> > + tar zxvf nasm-2.15rc12.tar.gz"<o:p></o:p> > + ```<o:p></o:p> > +- Build and install `nasm`<o:p></o:p> > + ```<o:p></o:p> > + cd nasm-2.15rc12<o:p></o:p> > + ./configure --prefix=/usr<o:p></o:p> > + sudo make install<o:p></o:p> > + ```<o:p></o:p> > +- Check to see if `nasm` reports desired version or not<o:p></o:p> > + ```<o:p></o:p> > + nasm -v<o:p></o:p> > + ```<o:p></o:p> > +### Build EDKII base tools<o:p></o:p> > +- Initial submodule (skip this if you already did this)<o:p></o:p> > + ```<o:p></o:p> > + git submodule update --init<o:p></o:p> > + ```<o:p></o:p> > +- Build base tools<o:p></o:p> > + ```<o:p></o:p> > + cd BaseTools<o:p></o:p> > + make<o:p></o:p> > + ```<o:p></o:p> > +## Build RedfishClientPkg<o:p></o:p> > +In order to reference RedfishClientPkg, we need to set `PACKAGES_PATH`<o:p></o:p> > +and specify the location of edk2-redfish-client repository.<o:p></o:p> > +```<o:p></o:p> > +export PACKAGES_PATH=$PWD/edk2:$PWD/edk2-redfish-client<o:p></o:p> > +cd $PWD/edk2<o:p></o:p> > +. ./edksetup.sh<o:p></o:p> > +build -p RedfishClientPkg/RedfishClientPkg.dsc -t GCC5 -a X64 ```<o:p></o:p> > --<o:p></o:p> > 2.17.1<o:p></o:p> > <o:p></o:p> > <o:p></o:p> > <o:p></o:p> > <o:p></o:p> > <o:p></o:p> <o:p> </o:p> </div> </div> </body> </html> <div width="1" style="color:white;clear:both">_._,_._,_</div> <hr> Groups.io Links: You receive all messages sent to this group. <a target="_blank" href="https://edk2.groups.io/g/devel/message/103406">View/Reply Online (#103406)</a> | | <a target="_blank" href="https://groups.io/mt/98403681/1813853">Mute This Topic</a> | <a href="https://edk2.groups.io/g/devel/post">New Topic</a> <a href="https://edk2.groups.io/g/devel/editsub/1813853">Your Subscription</a> | <a href="mailto:devel+owner@edk2.groups.io">Contact Group Owner</a> | <a href="https://edk2.groups.io/g/devel/leave/3943202/1813853/130120423/xyzzy">Unsubscribe</a> [edk2-devel-archive@redhat.com] <div width="1" style="color:white;clear:both">_._,_._,_</div>