Differences

This shows you the differences between two versions of the page.

appnote:named_config [2015/09/10 13:34] (current)
robinsmidsrod created
Line 1: Line 1:
 +====== Named configurations ======
 +
 +Named configurations can be specified via the ''CONFIG=...'' build
 +parameter.
 +
 +For headers in ''config/*.h'' which support named configurations, the following files are included when building with ''CONFIG=**<name>**'':
 +
 +  * ''config/defaults/<platform>.h'' (e.g. ''config/defaults/pcbios.h'')
 +  * ''config/<header>.h''
 +  * ''config/**<name>**/<header>.h'' (only if the directory ''config/**<name>**'' exists)
 +  * ''config/local/<header>.h'' (autocreated if necessary)
 +  * ''config/local/**<name>**/<header>.h'' (autocreated if necessary)
 +
 +This mechanism allows for predefined named configurations to be checked in to the source tree, as a directory ''config/**<name>**'' containing all of the required header files.
 +
 +The mechanism also allows for users to define multiple local configurations, by creating header files in the directory ''config/local/**<name>**''.
 +
 +Note that the ''config/*.h'' files which are used only to configure internal iPXE APIs (e.g. ''config/ioapi.h'') cannot be modified via a named configuration.  This avoids rebuilding the entire iPXE codebase whenever switching to a different named configuration.
 
appnote/named_config.txt · Last modified: 2015/09/10 13:34 by robinsmidsrod
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki
All uses of this content must include an attribution to the iPXE project and the URL http://ipxe.org
References to "iPXE" may not be altered or removed.