diff options
author | Darren Hart <dvhart@linux.intel.com> | 2014-01-17 22:26:21 +0000 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2014-01-28 00:50:54 +0000 |
commit | e010be1367da53e9273d0501bbaffd1f605c5b5c (patch) | |
tree | 01d72f0ef4d5914dbb3fef122792ff1be1254035 /meta/conf/machine | |
parent | beac8c5ac2b55b97dcce3d270d38ad4ec3825e44 (diff) | |
download | poky-e010be1367da53e9273d0501bbaffd1f605c5b5c.tar.gz |
tune: README: Whitespace cleanup
Before making content changes, cleanup the various whitespace errors in
this file. Mostly end-of-line whitepsace.
(From OE-Core rev: 112e291c14ce4c3b8d074b71e63500dce609784e)
Signed-off-by: Darren Hart <dvhart@linux.intel.com>
Cc: Richard Purdie <richard.purdie@linuxfoundation.org>
Cc: Paul Eggleton <paul.eggleton@intel.com>
Cc: Tom Zanussi <tom.zanussi@intel.com>
Cc: Nitin Kamble <nitin.a.kamble@intel.com>
Cc: Mark Hatle <mark.hatle@windriver.com>
Cc: Bruce Ashfield <bruce.ashfield@windriver.com>
Cc: Martin Jansa <martin.jansa@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'meta/conf/machine')
-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. |