diff options
| -rw-r--r-- | meta/conf/machine/include/README | 88 |
1 files changed, 44 insertions, 44 deletions
diff --git a/meta/conf/machine/include/README b/meta/conf/machine/include/README index e4b59c9566..65d09428a8 100644 --- a/meta/conf/machine/include/README +++ b/meta/conf/machine/include/README | |||
| @@ -1,27 +1,27 @@ | |||
| 1 | 2012/03/30 - Mark Hatle <mark.hatle@windriver.com> | 1 | 2012/03/30 - Mark Hatle <mark.hatle@windriver.com> |
| 2 | - Initial Revision | 2 | - Initial Revision |
| 3 | 3 | ||
| 4 | The individual CPU, and ABI tunings are contained in this directory. A | 4 | The individual CPU, and ABI tunings are contained in this directory. A |
| 5 | number of local and global variables are used to control the way the | 5 | number of local and global variables are used to control the way the |
| 6 | tunings are setup and how they work together to specify an optimized | 6 | tunings are setup and how they work together to specify an optimized |
| 7 | configuration. | 7 | configuration. |
| 8 | 8 | ||
| 9 | The following is brief summary of the generic components that are used | 9 | The following is brief summary of the generic components that are used |
| 10 | in these tunings. | 10 | in these tunings. |
| 11 | 11 | ||
| 12 | AVAILTUNES - This is a list of all of the tuning definitions currently | 12 | AVAILTUNES - This is a list of all of the tuning definitions currently |
| 13 | available in the system. Not all tunes in this list may be compatible | 13 | available in the system. Not all tunes in this list may be compatible |
| 14 | with the machine configuration, or each other in a multilib | 14 | with the machine configuration, or each other in a multilib |
| 15 | configuration. Each tuning file can add to this list using "+=", but | 15 | configuration. Each tuning file can add to this list using "+=", but |
| 16 | should never replace the list using "=". | 16 | should never replace the list using "=". |
| 17 | 17 | ||
| 18 | DEFAULTTUNE - This specifies the tune to use for a particular build. | 18 | DEFAULTTUNE - This specifies the tune to use for a particular build. |
| 19 | Each tune should specify a reasonable default, which can be overriden by | 19 | Each tune should specify a reasonable default, which can be overriden by |
| 20 | a machine or multilib configuration. The specified tune must be listed | 20 | a machine or multilib configuration. The specified tune must be listed |
| 21 | in the AVAILTUNES. | 21 | in the AVAILTUNES. |
| 22 | 22 | ||
| 23 | TUNEVALID[feature] - The <feature> is defined with a human readable | 23 | TUNEVALID[feature] - The <feature> is defined with a human readable |
| 24 | explanation for what it does. All architectural, cpu, abi, etc tuning | 24 | explanation for what it does. All architectural, cpu, abi, etc tuning |
| 25 | features must be defined using TUNEVALID. | 25 | features must be defined using TUNEVALID. |
| 26 | 26 | ||
| 27 | TUNECONFLICTS[feature] - A list of features which conflict with <feature>. | 27 | TUNECONFLICTS[feature] - A list of features which conflict with <feature>. |
| @@ -31,51 +31,51 @@ tuning ends up with features which conflict with each other. | |||
| 31 | TUNE_FEATURES - This is automatically defined as TUNE_FEATURES_tune-<tune>. | 31 | TUNE_FEATURES - This is automatically defined as TUNE_FEATURES_tune-<tune>. |
| 32 | See TUNE_FEATURES_tune-<tune> for more information. | 32 | See TUNE_FEATURES_tune-<tune> for more information. |
| 33 | 33 | ||
| 34 | TUNE_FEATURES_tune-<tune> - Specify the features used to describe a | 34 | TUNE_FEATURES_tune-<tune> - Specify the features used to describe a |
| 35 | specific tune. This is a list of features that a tune support, each | 35 | specific tune. This is a list of features that a tune support, each |
| 36 | feature must be in the TUNEVALID list. Note: the tune and a given | 36 | feature must be in the TUNEVALID list. Note: the tune and a given |
| 37 | feature name may be the same, but they have different purposes. Only | 37 | feature name may be the same, but they have different purposes. Only |
| 38 | features may be used to change behavior, while tunes are used to | 38 | features may be used to change behavior, while tunes are used to |
| 39 | describe an overall set of features. | 39 | describe an overall set of features. |
| 40 | 40 | ||
| 41 | ABIEXTENSION - An ABI extension may be specified by a specific feature | 41 | ABIEXTENSION - An ABI extension may be specified by a specific feature |
| 42 | or other tuning setting, such as TARGET_FPU. Any ABI extensions either | 42 | or other tuning setting, such as TARGET_FPU. Any ABI extensions either |
| 43 | need to be defined in the architectures base arch file, i.e. | 43 | need to be defined in the architectures base arch file, i.e. |
| 44 | ABIEXTENSION = "eabi" in the arm case, or appended to in specific tune | 44 | ABIEXTENSION = "eabi" in the arm case, or appended to in specific tune |
| 45 | files with a ".=". Spaces are not allowed in this variable. | 45 | files with a ".=". Spaces are not allowed in this variable. |
| 46 | 46 | ||
| 47 | TUNE_CCARGS - Setup the cflags based on the TUNE_FEATURES settings. | 47 | TUNE_CCARGS - Setup the cflags based on the TUNE_FEATURES settings. |
| 48 | These should be additive when defined using "+=". All items in this | 48 | These should be additive when defined using "+=". All items in this |
| 49 | list should be dynamic! i.e. | 49 | list should be dynamic! i.e. |
| 50 | ${@bb.utils.contains("TUNE_FEATURES", "feature", "cflag", "!cflag", d)} | 50 | ${@bb.utils.contains("TUNE_FEATURES", "feature", "cflag", "!cflag", d)} |
| 51 | 51 | ||
| 52 | TUNE_ARCH - The GNU canonical arch for a specific architecture. i.e. | 52 | TUNE_ARCH - The GNU canonical arch for a specific architecture. i.e. |
| 53 | arm, armeb, mips, mips64, etc. This value is by bitbake to setup | 53 | arm, armeb, mips, mips64, etc. This value is by bitbake to setup |
| 54 | configure. TUNE_ARCH definitions are specific to a given architecture. | 54 | configure. TUNE_ARCH definitions are specific to a given architecture. |
| 55 | They may be a single static definitions, or may be dynamically adjusted. | 55 | They may be a single static definitions, or may be dynamically adjusted. |
| 56 | See each architectures README for details for that CPU family. | 56 | See each architectures README for details for that CPU family. |
| 57 | 57 | ||
| 58 | TUNE_PKGARCH - The package architecture used by the packaging systems to | 58 | TUNE_PKGARCH - The package architecture used by the packaging systems to |
| 59 | define the architecture, abi and tuning of a particular package. | 59 | define the architecture, abi and tuning of a particular package. |
| 60 | Similarly to TUNE_ARCH, the definition of TUNE_PKGARCH is specific to | 60 | Similarly to TUNE_ARCH, the definition of TUNE_PKGARCH is specific to |
| 61 | each architecture. See each architectures README for details for that | 61 | each architecture. See each architectures README for details for that |
| 62 | CPU family. | 62 | CPU family. |
| 63 | 63 | ||
| 64 | PACKAGE_EXTRA_ARCHS - Lists all runtime compatible package | 64 | PACKAGE_EXTRA_ARCHS - Lists all runtime compatible package |
| 65 | architectures. By default this is equal to | 65 | architectures. By default this is equal to |
| 66 | PACKAGE_EXTRA_ARCHS_tune-<tune>. If an architecture deviates from the | 66 | PACKAGE_EXTRA_ARCHS_tune-<tune>. If an architecture deviates from the |
| 67 | default it will be listed in the architecture README. | 67 | default it will be listed in the architecture README. |
| 68 | 68 | ||
| 69 | PACKAGE_EXTRA_ARCHS_tune-<tune> - List all of the package architectures | 69 | PACKAGE_EXTRA_ARCHS_tune-<tune> - List all of the package architectures |
| 70 | that are compatible with this specific tune. The package arch of this | 70 | that are compatible with this specific tune. The package arch of this |
| 71 | tune must be in the list. | 71 | tune must be in the list. |
| 72 | 72 | ||
| 73 | TARGET_FPU - The FPU setting for a given tune, hard (generate floating | 73 | TARGET_FPU - The FPU setting for a given tune, hard (generate floating |
| 74 | point instructions), soft (generate internal gcc calls), "other" | 74 | point instructions), soft (generate internal gcc calls), "other" |
| 75 | architecture specific floating point. This is synchronized with the | 75 | architecture specific floating point. This is synchronized with the |
| 76 | compiler and other toolchain items. This should be dynamically | 76 | compiler and other toolchain items. This should be dynamically |
| 77 | configured in the same way that TUNE_CCARGS is. | 77 | configured in the same way that TUNE_CCARGS is. |
| 78 | 78 | ||
| 79 | BASE_LIB_tune-<tune> - The "/lib" location for a specific ABI. This is | 79 | BASE_LIB_tune-<tune> - The "/lib" location for a specific ABI. This is |
| 80 | used in a multilib configuration to place the libraries in the correct, | 80 | used in a multilib configuration to place the libraries in the correct, |
| 81 | non-conflicting locations. | 81 | non-conflicting locations. |
