[doc] clarify that partitioning table buffer size is measured in bytes

Author: parmi93

api/stse_data_storage.c

@@ -43,15 +43,15 @@ stse_ReturnCode_t stse_data_storage_get_partitioning_table(
     stse_Handler_t *pSTSE,
     PLAT_UI8 total_partition_count,
     stsafea_data_partition_record_t *pPartitioning_table,
-    PLAT_UI16 Partitioning_table_length) {
+    PLAT_UI16 partitioning_table_size) {
 
     stse_ReturnCode_t ret = STSE_API_INCOMPATIBLE_DEVICE_TYPE;
 
 #ifdef STSE_CONF_STSAFE_A_SUPPORT
 #ifdef STSE_CONF_STSAFE_L_SUPPORT
     if (pSTSE->device_type != STSAFE_L010) {
 #endif /* STSE_CONF_STSAFE_L_SUPPORT */
-        ret = stsafea_get_data_partitions_configuration(pSTSE, total_partition_count, pPartitioning_table, Partitioning_table_length);
+        ret = stsafea_get_data_partitions_configuration(pSTSE, total_partition_count, pPartitioning_table, partitioning_table_size);
 #ifdef STSE_CONF_STSAFE_L_SUPPORT
     }
 #endif /* STSE_CONF_STSAFE_L_SUPPORT */

api/stse_data_storage.h

@@ -49,15 +49,15 @@ stse_ReturnCode_t stse_data_storage_get_total_partition_count(
  * \param[in]   pSTSE                   Pointer to target STSE handler
  * \param[in]   total_partition_count   Total partition count
  * \param[out]  pPartitioning_table     Pointer to the partition table buffer
- * \param[in]   Partitioning_table_length Length of the partition table to be received
+ * \param[in]   partitioning_table_size Size (in bytes) of the partition table (@p pPartitioning_table) to be received
  * \return \ref STSE_OK on success ; \ref stse_ReturnCode_t error code otherwise
  * \details \include{doc} stse_data_storage_get_partitioning_table.dox
  */
 stse_ReturnCode_t stse_data_storage_get_partitioning_table(
     stse_Handler_t *pSTSE,
     PLAT_UI8 total_partition_count,
     stsafea_data_partition_record_t *pPartitioning_table,
-    PLAT_UI16 Partitioning_table_length);
+    PLAT_UI16 partitioning_table_size);
 
 /*!
  * \brief       Read one memory zone of the STSE device

doc/resources/dox_files/APIs/data_storage/stse_data_storage_get_partitioning_table.dox

@@ -46,7 +46,8 @@ Following diagram illustrates the interactions performed between the Host and th
     stse_ret = stse_data_storage_get_partitioning_table(
             &stse_handler,
             total_zone_count,
-            data_partition_record_table
+            data_partition_record_table,
+            sizeof(data_partition_record_table)
     );
     if(stse_ret != STSE_OK )
     {

doc/resources/dox_files/APIs/data_storage/stse_data_storage_get_total_partition_count.dox

@@ -48,7 +48,8 @@ Following diagram illustrates the interactions performed between the Host and th
     stse_ret = stse_data_storage_get_partitioning_table(
             &stse_handler,
             total_zone_count,
-            data_partition_record_table
+            data_partition_record_table,
+            sizeof(data_partition_record_table)
     );
     if(stse_ret != STSE_OK )
     {

services/stsafea/stsafea_data_partition.c

@@ -78,13 +78,13 @@ stse_ReturnCode_t stsafea_get_total_partition_count(stse_Handler_t *pSTSE,
 stse_ReturnCode_t stsafea_get_data_partitions_configuration(stse_Handler_t *pSTSE,
                                                             PLAT_UI8 total_partitions_count,
                                                             stsafea_data_partition_record_t *pRecord_table,
-                                                            PLAT_UI16 record_table_length) {
+                                                            PLAT_UI16 record_table_size) {
     stse_ReturnCode_t ret;
     volatile PLAT_UI8 partition_idx;
     PLAT_UI8 cmd_header = STSAFEA_CMD_QUERY;
     PLAT_UI8 tag = STSAFEA_SUBJECT_TAG_DATA_PARTITION_CONFIGURATION;
     PLAT_UI8 rsp_header;
-    PLAT_UI8 raw_data[record_table_length];
+    PLAT_UI8 raw_data[record_table_size];
 
     if (pSTSE == NULL) {
         return STSE_SERVICE_HANDLER_NOT_INITIALISED;
@@ -98,7 +98,7 @@ stse_ReturnCode_t stsafea_get_data_partitions_configuration(stse_Handler_t *pSTS
     /*- Create Rsp frame and populate elements*/
     stse_frame_allocate(RspFrame);
     stse_frame_element_allocate_push(&RspFrame, eRsp_header, 1, &rsp_header);
-    stse_frame_element_allocate_push(&RspFrame, eRaw, record_table_length, raw_data);
+    stse_frame_element_allocate_push(&RspFrame, eRaw, record_table_size, raw_data);
 
     /*- Perform Transfer*/
     ret = stsafea_frame_raw_transfer(pSTSE,

services/stsafea/stsafea_data_partition.h

@@ -113,13 +113,13 @@ stse_ReturnCode_t stsafea_get_total_partition_count(stse_Handler_t *pSTSE,
  * \param[in]		pSTSE					Pointer to target SE handler
  * \param[in]		total_partitions_count	Total partition count in bytes
  * \param[in,out]	pRecord_table			Pointer to applicative partition record table
- * \param[in]		record_table_length		Applicative record table length
+ * \param[in]		record_table_size		Applicative record table (@p pRecord_table) size (in bytes)
  * \return 			\ref STSE_OK on success ; \ref stse_ReturnCode_t error code otherwise
  */
 stse_ReturnCode_t stsafea_get_data_partitions_configuration(stse_Handler_t *pSTSE,
                                                             PLAT_UI8 total_partitions_count,
                                                             stsafea_data_partition_record_t *pRecord_table,
-                                                            PLAT_UI16 record_table_length);
+                                                            PLAT_UI16 record_table_size);
 
 /**
  * \brief 		Decrement counter zone