1# OpenBMC documentation 2 3This repository contains documentation for OpenBMC as a whole. There may 4be component-specific documentation in the repository for each component. 5 6OpenBMC Usage 7------------- 8 9These documents describe how to use OpenBMC, including using the programmatic 10interfaces to an OpenBMC system. 11 12 - [rest-api.md](rest-api.md): Introduction to using the OpenBMC REST API 13 14 - [console.md](console.md): Using the host console 15 16 - [host-management.md](host-management.md): Performing host management tasks 17 with OpenBMC 18 19 - [code-update.md](code-update.md): Updating OpenBMC and host platform firmware 20 21 22OpenBMC Development 23------------------- 24 25These documents contain details on developing OpenBMC code itself 26 27 - [cheatsheet.md](cheatsheet.md): Quick reference for some common 28 development tasks 29 30 - [contributing.md](contributing.md): Guidelines for contributing to 31 OpenBMC 32 33 - [dbus-interfaces.md](dbus-interfaces.md): Reference for APIs exposed 34 to dbus 35 36 - [kernel-development.md](kernel-development.md): Reference for common 37 kernel development tasks 38 39 40OpenBMC Goals 41------------- 42 43The OpenBMC project's aim is to create a highly extensible framework for BMC 44software and implement for data-center computer systems. 45 46We have a few high-level objectives: 47 48 * The OpenBMC framework must be extensible, easily to learn, and usable in a 49 variety of programming languages. 50 51 * Provide a REST API for external management, and allow for "pluggable" 52 interfaces for other types of management interactions. 53 54 * Provide a remote host console, accessible over the network 55 56 * Persist network configuration settable from REST interface and host 57 58 * Provide a robust solution for RTC management, exposed to the host. 59 60 * Compatible with host firmware implementations for basic IPMI communication 61 between host and BMC 62 63 * Provide a flexible and hierarchical inventory tracking component 64 65 * Maintain a sensor database and track thresholds 66