Copyright 2017-2019 DMTF. All rights reserved.

libRedfish is a C client library that allows for Creation of Entities (POST), Read of Entities (GET), Update of Entities (PATCH), Deletion of Entities (DELETE), running Actions (POST), receiving events, and providing some basic query abilities.

1. Add the EPEL repository # yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
2. Install libjansson, libcurl, and libreadline # yum install jansson libcurl readline
3. Download RPM (example only please download latest RPM) $ wget https://github.com/DMTF/libredfish/releases/download/1.2.0/libredfish-1.2.0-1.el7.x86_64.rpm
4. Install the RPM (substititue the file name from the lastest RPM) # rpm -ivh libredfish-1.2.0-1.el7.x86_64.rpm

1. Add the EPEL repository # yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm
2. Install libjansson, libcurl, and libreadline # yum install jansson libcurl readline
3. Download RPM (example only please download latest RPM) $ wget https://github.com/DMTF/libredfish/releases/download/1.2.0/libredfish-1.2.0-1.el6.x86_64.rpm
4. Install the RPM (substititue the file name from the lastest RPM) # rpm -ivh libredfish-1.2.0-1.el6.x86_64.rpm

1. Install libjansson, libcurl, and libreadline apt-get install libjansson4 libcurl4 libreadline7
2. Download Debian Package
3. Install Debian Package #dpkg -i libredfish-1.2.0-1.x86_64.deb

Compile from source, see below.

libRedfish is based on C and the compiling system is required to have:

• CMake
• C Compiler
• libjansson - http://www.digip.org/jansson/
• libcurl - https://curl.haxx.se/libcurl/ To receive events a user needs an existing webserver supporting FastCGI (such as Apache or nginx) and libczmq (https://github.com/zeromq/czmq).

Run cmake.

libRedfish uses a query language based on XPath (https://www.w3.org/TR/1999/REC-xpath-19991116/). This library and query language essentially treat the entire Redfish Service like it was a single JSON document. In other words whenever it encounters an @odata.id it will retrieve the new document (if needed).

Some examples:

• /Chassis[1] - Will return the first Chassis instance
• /Chassis[SKU=1234] - Will return all Chassis instances with a SKU field equal to 1234
• /Systems[Storage] - Will return all the System instances that have Storage field populated
• /Systems[*] - Will return all the System instances
• /SessionService/Sessions[last()] - Will return the last Session instance
• /Chassis[Location.Info] - Will return all the Chassis instances that have a Location field and a Info subfield of Location
• /Systems[Status.Health=OK] - Will return all System instances that have a Health of OK

#include <redfish.h>
#include <stdio.h>

int main(int argc, char** argv)
{
    redfishService* service = createRedfishServiceEnumerator(argv[1], NULL, NULL, 0);
    redfishPayload* payload = getPayloadByPath(service, argv[2]);
    char* payloadStr = payloadToString(payload, true);
    printf("Payload Value = %s\n", payloadStr);
    free(payloadStr);
    cleanupPayload(payload);
    cleanupEnumerator(service);
}

1. Update CHANGELOG.md with the list of changes since the last release
2. Update Version in rpm/libredfish.spec to reflect the new library version
3. Push changes to Github
4. Create a new release in Github