Commit 0a16d12a authored by Bob Moore's avatar Bob Moore Committed by Rafael J. Wysocki

ACPICA: Comment update - no functional change.

Change all instances of "sub-package" to "subpackage" for consistency.
Signed-off-by: default avatarBob Moore <robert.moore@intel.com>
Signed-off-by: default avatarLv Zheng <lv.zheng@intel.com>
Signed-off-by: default avatarRafael J. Wysocki <rafael.j.wysocki@intel.com>
parent 69e6bb68
...@@ -50,7 +50,7 @@ ...@@ -50,7 +50,7 @@
* *
* Return Package types * Return Package types
* *
* 1) PTYPE1 packages do not contain sub-packages. * 1) PTYPE1 packages do not contain subpackages.
* *
* ACPI_PTYPE1_FIXED: Fixed-length length, 1 or 2 object types: * ACPI_PTYPE1_FIXED: Fixed-length length, 1 or 2 object types:
* object type * object type
...@@ -65,8 +65,8 @@ ...@@ -65,8 +65,8 @@
* (Used for _PRW) * (Used for _PRW)
* *
* *
* 2) PTYPE2 packages contain a Variable-length number of sub-packages. Each * 2) PTYPE2 packages contain a Variable-length number of subpackages. Each
* of the different types describe the contents of each of the sub-packages. * of the different types describe the contents of each of the subpackages.
* *
* ACPI_PTYPE2: Each subpackage contains 1 or 2 object types. Zero-length * ACPI_PTYPE2: Each subpackage contains 1 or 2 object types. Zero-length
* parent package is allowed: * parent package is allowed:
...@@ -562,7 +562,7 @@ const union acpi_predefined_info acpi_gbl_predefined_methods[] = { ...@@ -562,7 +562,7 @@ const union acpi_predefined_info acpi_gbl_predefined_methods[] = {
/* /*
* For _HPX, a single package is returned, containing a variable-length number * For _HPX, a single package is returned, containing a variable-length number
* of sub-packages. Each sub-package contains a PCI record setting. * of subpackages. Each subpackage contains a PCI record setting.
* There are several different type of record settings, of different * There are several different type of record settings, of different
* lengths, but all elements of all settings are Integers. * lengths, but all elements of all settings are Integers.
*/ */
......
...@@ -132,12 +132,12 @@ acpi_ns_check_package(struct acpi_evaluate_info *info, ...@@ -132,12 +132,12 @@ acpi_ns_check_package(struct acpi_evaluate_info *info,
* Decode the type of the expected package contents * Decode the type of the expected package contents
* *
* PTYPE1 packages contain no subpackages * PTYPE1 packages contain no subpackages
* PTYPE2 packages contain sub-packages * PTYPE2 packages contain subpackages
*/ */
switch (package->ret_info.type) { switch (package->ret_info.type) {
case ACPI_PTYPE1_FIXED: case ACPI_PTYPE1_FIXED:
/* /*
* The package count is fixed and there are no sub-packages * The package count is fixed and there are no subpackages
* *
* If package is too small, exit. * If package is too small, exit.
* If package is larger than expected, issue warning but continue * If package is larger than expected, issue warning but continue
...@@ -169,7 +169,7 @@ acpi_ns_check_package(struct acpi_evaluate_info *info, ...@@ -169,7 +169,7 @@ acpi_ns_check_package(struct acpi_evaluate_info *info,
case ACPI_PTYPE1_VAR: case ACPI_PTYPE1_VAR:
/* /*
* The package count is variable, there are no sub-packages, and all * The package count is variable, there are no subpackages, and all
* elements must be of the same type * elements must be of the same type
*/ */
for (i = 0; i < count; i++) { for (i = 0; i < count; i++) {
...@@ -185,7 +185,7 @@ acpi_ns_check_package(struct acpi_evaluate_info *info, ...@@ -185,7 +185,7 @@ acpi_ns_check_package(struct acpi_evaluate_info *info,
case ACPI_PTYPE1_OPTION: case ACPI_PTYPE1_OPTION:
/* /*
* The package count is variable, there are no sub-packages. There are * The package count is variable, there are no subpackages. There are
* a fixed number of required elements, and a variable number of * a fixed number of required elements, and a variable number of
* optional elements. * optional elements.
* *
...@@ -242,7 +242,7 @@ acpi_ns_check_package(struct acpi_evaluate_info *info, ...@@ -242,7 +242,7 @@ acpi_ns_check_package(struct acpi_evaluate_info *info,
elements++; elements++;
count--; count--;
/* Examine the sub-packages */ /* Examine the subpackages */
status = status =
acpi_ns_check_package_list(info, package, elements, count); acpi_ns_check_package_list(info, package, elements, count);
...@@ -250,7 +250,7 @@ acpi_ns_check_package(struct acpi_evaluate_info *info, ...@@ -250,7 +250,7 @@ acpi_ns_check_package(struct acpi_evaluate_info *info,
case ACPI_PTYPE2_PKG_COUNT: case ACPI_PTYPE2_PKG_COUNT:
/* First element is the (Integer) count of sub-packages to follow */ /* First element is the (Integer) count of subpackages to follow */
status = acpi_ns_check_object_type(info, elements, status = acpi_ns_check_object_type(info, elements,
ACPI_RTYPE_INTEGER, 0); ACPI_RTYPE_INTEGER, 0);
...@@ -270,7 +270,7 @@ acpi_ns_check_package(struct acpi_evaluate_info *info, ...@@ -270,7 +270,7 @@ acpi_ns_check_package(struct acpi_evaluate_info *info,
count = expected_count; count = expected_count;
elements++; elements++;
/* Examine the sub-packages */ /* Examine the subpackages */
status = status =
acpi_ns_check_package_list(info, package, elements, count); acpi_ns_check_package_list(info, package, elements, count);
...@@ -283,9 +283,9 @@ acpi_ns_check_package(struct acpi_evaluate_info *info, ...@@ -283,9 +283,9 @@ acpi_ns_check_package(struct acpi_evaluate_info *info,
case ACPI_PTYPE2_FIX_VAR: case ACPI_PTYPE2_FIX_VAR:
/* /*
* These types all return a single Package that consists of a * These types all return a single Package that consists of a
* variable number of sub-Packages. * variable number of subpackages.
* *
* First, ensure that the first element is a sub-Package. If not, * First, ensure that the first element is a subpackage. If not,
* the BIOS may have incorrectly returned the object as a single * the BIOS may have incorrectly returned the object as a single
* package instead of a Package of Packages (a common error if * package instead of a Package of Packages (a common error if
* there is only one entry). We may be able to repair this by * there is only one entry). We may be able to repair this by
...@@ -310,7 +310,7 @@ acpi_ns_check_package(struct acpi_evaluate_info *info, ...@@ -310,7 +310,7 @@ acpi_ns_check_package(struct acpi_evaluate_info *info,
count = 1; count = 1;
} }
/* Examine the sub-packages */ /* Examine the subpackages */
status = status =
acpi_ns_check_package_list(info, package, elements, count); acpi_ns_check_package_list(info, package, elements, count);
...@@ -370,9 +370,9 @@ acpi_ns_check_package_list(struct acpi_evaluate_info *info, ...@@ -370,9 +370,9 @@ acpi_ns_check_package_list(struct acpi_evaluate_info *info,
u32 j; u32 j;
/* /*
* Validate each sub-Package in the parent Package * Validate each subpackage in the parent Package
* *
* NOTE: assumes list of sub-packages contains no NULL elements. * NOTE: assumes list of subpackages contains no NULL elements.
* Any NULL elements should have been removed by earlier call * Any NULL elements should have been removed by earlier call
* to acpi_ns_remove_null_elements. * to acpi_ns_remove_null_elements.
*/ */
...@@ -389,7 +389,7 @@ acpi_ns_check_package_list(struct acpi_evaluate_info *info, ...@@ -389,7 +389,7 @@ acpi_ns_check_package_list(struct acpi_evaluate_info *info,
return (status); return (status);
} }
/* Examine the different types of expected sub-packages */ /* Examine the different types of expected subpackages */
info->parent_package = sub_package; info->parent_package = sub_package;
switch (package->ret_info.type) { switch (package->ret_info.type) {
...@@ -450,14 +450,14 @@ acpi_ns_check_package_list(struct acpi_evaluate_info *info, ...@@ -450,14 +450,14 @@ acpi_ns_check_package_list(struct acpi_evaluate_info *info,
case ACPI_PTYPE2_FIXED: case ACPI_PTYPE2_FIXED:
/* Each sub-package has a fixed length */ /* Each subpackage has a fixed length */
expected_count = package->ret_info2.count; expected_count = package->ret_info2.count;
if (sub_package->package.count < expected_count) { if (sub_package->package.count < expected_count) {
goto package_too_small; goto package_too_small;
} }
/* Check the type of each sub-package element */ /* Check the type of each subpackage element */
for (j = 0; j < expected_count; j++) { for (j = 0; j < expected_count; j++) {
status = status =
...@@ -475,14 +475,14 @@ acpi_ns_check_package_list(struct acpi_evaluate_info *info, ...@@ -475,14 +475,14 @@ acpi_ns_check_package_list(struct acpi_evaluate_info *info,
case ACPI_PTYPE2_MIN: case ACPI_PTYPE2_MIN:
/* Each sub-package has a variable but minimum length */ /* Each subpackage has a variable but minimum length */
expected_count = package->ret_info.count1; expected_count = package->ret_info.count1;
if (sub_package->package.count < expected_count) { if (sub_package->package.count < expected_count) {
goto package_too_small; goto package_too_small;
} }
/* Check the type of each sub-package element */ /* Check the type of each subpackage element */
status = status =
acpi_ns_check_package_elements(info, sub_elements, acpi_ns_check_package_elements(info, sub_elements,
...@@ -531,7 +531,7 @@ acpi_ns_check_package_list(struct acpi_evaluate_info *info, ...@@ -531,7 +531,7 @@ acpi_ns_check_package_list(struct acpi_evaluate_info *info,
(*sub_elements)->integer.value = expected_count; (*sub_elements)->integer.value = expected_count;
} }
/* Check the type of each sub-package element */ /* Check the type of each subpackage element */
status = status =
acpi_ns_check_package_elements(info, acpi_ns_check_package_elements(info,
...@@ -557,10 +557,10 @@ acpi_ns_check_package_list(struct acpi_evaluate_info *info, ...@@ -557,10 +557,10 @@ acpi_ns_check_package_list(struct acpi_evaluate_info *info,
package_too_small: package_too_small:
/* The sub-package count was smaller than required */ /* The subpackage count was smaller than required */
ACPI_WARN_PREDEFINED((AE_INFO, info->full_pathname, info->node_flags, ACPI_WARN_PREDEFINED((AE_INFO, info->full_pathname, info->node_flags,
"Return Sub-Package[%u] is too small - found %u elements, expected %u", "Return SubPackage[%u] is too small - found %u elements, expected %u",
i, sub_package->package.count, expected_count)); i, sub_package->package.count, expected_count));
return (AE_AML_OPERAND_VALUE); return (AE_AML_OPERAND_VALUE);
......
...@@ -465,7 +465,7 @@ acpi_ns_repair_null_element(struct acpi_evaluate_info * info, ...@@ -465,7 +465,7 @@ acpi_ns_repair_null_element(struct acpi_evaluate_info * info,
* RETURN: None. * RETURN: None.
* *
* DESCRIPTION: Remove all NULL package elements from packages that contain * DESCRIPTION: Remove all NULL package elements from packages that contain
* a variable number of sub-packages. For these types of * a variable number of subpackages. For these types of
* packages, NULL elements can be safely removed. * packages, NULL elements can be safely removed.
* *
*****************************************************************************/ *****************************************************************************/
...@@ -486,7 +486,7 @@ acpi_ns_remove_null_elements(struct acpi_evaluate_info *info, ...@@ -486,7 +486,7 @@ acpi_ns_remove_null_elements(struct acpi_evaluate_info *info,
/* /*
* We can safely remove all NULL elements from these package types: * We can safely remove all NULL elements from these package types:
* PTYPE1_VAR packages contain a variable number of simple data types. * PTYPE1_VAR packages contain a variable number of simple data types.
* PTYPE2 packages contain a variable number of sub-packages. * PTYPE2 packages contain a variable number of subpackages.
*/ */
switch (package_type) { switch (package_type) {
case ACPI_PTYPE1_VAR: case ACPI_PTYPE1_VAR:
......
...@@ -432,8 +432,8 @@ acpi_ns_repair_CID(struct acpi_evaluate_info *info, ...@@ -432,8 +432,8 @@ acpi_ns_repair_CID(struct acpi_evaluate_info *info,
* DESCRIPTION: Repair for the _CST object: * DESCRIPTION: Repair for the _CST object:
* 1. Sort the list ascending by C state type * 1. Sort the list ascending by C state type
* 2. Ensure type cannot be zero * 2. Ensure type cannot be zero
* 3. A sub-package count of zero means _CST is meaningless * 3. A subpackage count of zero means _CST is meaningless
* 4. Count must match the number of C state sub-packages * 4. Count must match the number of C state subpackages
* *
*****************************************************************************/ *****************************************************************************/
...@@ -686,7 +686,7 @@ acpi_ns_repair_PSS(struct acpi_evaluate_info *info, ...@@ -686,7 +686,7 @@ acpi_ns_repair_PSS(struct acpi_evaluate_info *info,
u32 i; u32 i;
/* /*
* Entries (sub-packages) in the _PSS Package must be sorted by power * Entries (subpackages) in the _PSS Package must be sorted by power
* dissipation, in descending order. If it appears that the list is * dissipation, in descending order. If it appears that the list is
* incorrectly sorted, sort it. We sort by cpu_frequency, since this * incorrectly sorted, sort it. We sort by cpu_frequency, since this
* should be proportional to the power. * should be proportional to the power.
...@@ -774,9 +774,9 @@ acpi_ns_repair_TSS(struct acpi_evaluate_info *info, ...@@ -774,9 +774,9 @@ acpi_ns_repair_TSS(struct acpi_evaluate_info *info,
* *
* PARAMETERS: info - Method execution information block * PARAMETERS: info - Method execution information block
* return_object - Pointer to the top-level returned object * return_object - Pointer to the top-level returned object
* start_index - Index of the first sub-package * start_index - Index of the first subpackage
* expected_count - Minimum length of each sub-package * expected_count - Minimum length of each subpackage
* sort_index - Sub-package entry to sort on * sort_index - Subpackage entry to sort on
* sort_direction - Ascending or descending * sort_direction - Ascending or descending
* sort_key_name - Name of the sort_index field * sort_key_name - Name of the sort_index field
* *
...@@ -812,7 +812,7 @@ acpi_ns_check_sorted_list(struct acpi_evaluate_info *info, ...@@ -812,7 +812,7 @@ acpi_ns_check_sorted_list(struct acpi_evaluate_info *info,
} }
/* /*
* NOTE: assumes list of sub-packages contains no NULL elements. * NOTE: assumes list of subpackages contains no NULL elements.
* Any NULL elements should have been removed by earlier call * Any NULL elements should have been removed by earlier call
* to acpi_ns_remove_null_elements. * to acpi_ns_remove_null_elements.
*/ */
...@@ -839,7 +839,7 @@ acpi_ns_check_sorted_list(struct acpi_evaluate_info *info, ...@@ -839,7 +839,7 @@ acpi_ns_check_sorted_list(struct acpi_evaluate_info *info,
return (AE_AML_OPERAND_TYPE); return (AE_AML_OPERAND_TYPE);
} }
/* Each sub-package must have the minimum length */ /* Each subpackage must have the minimum length */
if ((*outer_elements)->package.count < expected_count) { if ((*outer_elements)->package.count < expected_count) {
return (AE_AML_PACKAGE_LIMIT); return (AE_AML_PACKAGE_LIMIT);
......
...@@ -636,7 +636,7 @@ acpi_rs_get_pci_routing_table_length(union acpi_operand_object *package_object, ...@@ -636,7 +636,7 @@ acpi_rs_get_pci_routing_table_length(union acpi_operand_object *package_object,
for (index = 0; index < number_of_elements; index++) { for (index = 0; index < number_of_elements; index++) {
/* Dereference the sub-package */ /* Dereference the subpackage */
package_element = *top_object_list; package_element = *top_object_list;
......
...@@ -273,7 +273,7 @@ acpi_rs_create_pci_routing_table(union acpi_operand_object *package_object, ...@@ -273,7 +273,7 @@ acpi_rs_create_pci_routing_table(union acpi_operand_object *package_object,
*/ */
user_prt->length = (sizeof(struct acpi_pci_routing_table) - 4); user_prt->length = (sizeof(struct acpi_pci_routing_table) - 4);
/* Each sub-package must be of length 4 */ /* Each subpackage must be of length 4 */
if ((*top_object_list)->package.count != 4) { if ((*top_object_list)->package.count != 4) {
ACPI_ERROR((AE_INFO, ACPI_ERROR((AE_INFO,
...@@ -283,7 +283,7 @@ acpi_rs_create_pci_routing_table(union acpi_operand_object *package_object, ...@@ -283,7 +283,7 @@ acpi_rs_create_pci_routing_table(union acpi_operand_object *package_object,
} }
/* /*
* Dereference the sub-package. * Dereference the subpackage.
* The sub_object_list will now point to an array of the four IRQ * The sub_object_list will now point to an array of the four IRQ
* elements: [Address, Pin, Source, source_index] * elements: [Address, Pin, Source, source_index]
*/ */
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment