Fix the iio-gts-helpers available times table sorting
Subsystems (2)
Matti Vaittinen
maintainercover Fix the iio-gts-helpers available times table sorting
Fix the available times table sorting in iio-gts-helpers
This series contains a fix and test for the sorting of the available times in IIO-gts helpers. Fix was originally developed and posted by Chenyuan Yang.
Chenyuan Yang (1):
iio: Fix the sorting functionality in iio_gts_build_avail_time_table
Matti Vaittinen (1):
iio: test: gts: test available times and gains sorting
drivers/iio/industrialio-gts-helper.c | 7 +++++-- drivers/iio/test/iio-test-gts.c | 8 +++++--- 2 files changed, 10 insertions(+), 5 deletions(-)
base-commit: 4cece764965020c22cff7665b18a012006359095
Signature · 14 lines
2.44.0 -- Matti Vaittinen, Linux device drivers ROHM Semiconductors, Finland SWDC Kiviharjunlenkki 1E 90220 OULU FINLAND ~~~ "I don't think so," said Rene Descartes. Just then he vanished ~~~ Simon says - in Latin please. ~~~ "non cogito me" dixit Rene Descarte, deinde evanescavit ~~~ Thanks to Simon Glass for the translation =]
Chenyuan Yang
maintainerPATCH 1/2 iio: Fix the sorting functionality in iio_gts_build_avail_time_table
The sorting in iio_gts_build_avail_time_table is not working as intended. It could result in an out-of-bounds access when the time is zero.
Here are more details:
1. When the gts->itime_table[i].time_us is zero, e.g., the time sequence is 3, 0, 1, the inner for-loop will not terminate and do out-of-bound writes. This is because once times[j] > new, the value new will be added in the current position and the times[j] will be moved to j+1 position, which makes the if-condition always hold. Meanwhile, idx will be added one, making the loop keep running without termination and out-of-bound write.
2. If none of the gts->itime_table[i].time_us is zero, the elements will just be copied without being sorted as described in the comment "Sort times from all tables to one and remove duplicates".
For more details, please refer to
https://lore.kernel.org/all/[email protected].
---
Original commit (by Chenyuan Yang) was amended by me to remove duplicates so that the user-space callers do not get multiple instances of same time as was discussed here:
https://lore.kernel.org/all/[email protected]/
--- drivers/iio/industrialio-gts-helper.c | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-)
drivers/iio/industrialio-gts-helper.c +5 -2
@@ -362,17 +362,20 @@ static int iio_gts_build_avail_time_table(struct iio_gts *gts)for (i = gts->num_itime -1 ; i >=0 ; i--) {int new = gts->itime_table[i].time_us; -if (times[idx] < new) { +if (idx ==0 || times[idx -1 ] < new) { times[idx++] = new;continue ; } -for (j =0 ; j <= idx; j++) { +for (j =0 ; j < idx; j++) { +if (times[j] == new) +break ;if (times[j] > new) {memmove (×[j +1 ], ×[j], (idx - j) *sizeof (int )); times[j] = new; idx++; +break ; } } }
Signature · 14 lines
2.44.0 -- Matti Vaittinen, Linux device drivers ROHM Semiconductors, Finland SWDC Kiviharjunlenkki 1E 90220 OULU FINLAND ~~~ "I don't think so," said Rene Descartes. Just then he vanished ~~~ Simon says - in Latin please. ~~~ "non cogito me" dixit Rene Descarte, deinde evanescavit ~~~ Thanks to Simon Glass for the translation =]
Matti Vaittinen
maintainerRe: [PATCH 1/2] iio: Fix the sorting functionality in iio_gts_build_avail_time_table
Quoted 19 lines · Chenyuan Yang
The sorting in
iio_gts_build_avail_time_tableis not working as intended. It could result in an out-of-bounds access when the time is zero.Here are more details:
1. When the gts->itime_table[i].time_us is zero, e.g., the time sequence is
3, 0, 1, the inner for-loop will not terminate and do out-of-bound writes. This is because oncetimes[j] > new, the valuenewwill be added in the current position and thetimes[j]will be moved toj+1position, which makes the if-condition always hold. Meanwhile, idx will be added one, making the loop keep running without termination and out-of-bound write.
2. If none of the gts->itime_table[i].time_us is zero, the elements will just be copied without being sorted as described in the comment "Sort times from all tables to one and remove duplicates".For more details, please refer to
https://lore.kernel.org/all/[email protected].
Quoted 7 lines
Reported-by Chenyuan Yang <[email protected]>Suggested-by Matti Vaittinen <[email protected]>Fixes 38416c28e168 ("iio: light: Add gain-time-scale helpers")Co-developed-by Chenyuan Yang <[email protected]>Signed-off-by Chenyuan Yang <[email protected]>Co-developed-by Matti Vaittinen <[email protected]>Signed-off-by Matti Vaittinen <[email protected]>
Huh. I had never before sent a patch with co-authored tags. Just to ensure there is no misunderstandings - I did send this patch mail. I added the From: tag as was suggested in:
https://www.kernel.org/doc/html/latest/process/submitting-patches.html
I am afraid mutt picked the email sender from this tag - which does not fee like correct thing to do! Sorry! I did not intend to impersonate Chenyuan!
Yours,
-- Matti
Signature · 5 lines
Matti Vaittinen Linux kernel developer at ROHM Semiconductors Oulu Finland ~~ When things go utterly wrong vim users can always type :help! ~~
Matti Vaittinen
maintainerPATCH 2/2 iio: test: gts: test available times and gains sorting
In reply to Matti VaittinenThe iio_gts helpers build available times and scales tables based on the times and gains arrays given from the driver. The driver should be able to list all valid register values so that conversion from register valu to correct gain/time works for all supported register values.
It might be more convenient for drivers to list these times and gains in the order where they're listed in the data-sheet than ascending order.
However, for user who requests the supported scales / times it is more convenient to get the results in asscending order. Also, listing duplicated values is not meaning for the user.
Hence the GTS heler should do sorting and deduplication of the scales and times when it builds the tables listing the available times/scales. Note, currently duplicated gain values aren't handled by GTS-helpers.
Unsort the gain and time arrays in the test code, and add duplicates to time array in order to test the sorting and deduplicating works.
--- drivers/iio/test/iio-test-gts.c | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-)
drivers/iio/test/iio-test-gts.c +5 -3
@@ -70,6 +70,7 @@*/ static struct iio_gts gts; +/* Keep the gain and time tables unsorted to test the sorting */ static const struct iio_gain_sel_pair gts_test_gains[] = {GAIN_SCALE_GAIN (1 ,TEST_GSEL_1 ),GAIN_SCALE_GAIN (4 ,TEST_GSEL_4 ),
@@ -79,16 +80,17 @@ static const struct iio_gain_sel_pair gts_test_gains[] = {GAIN_SCALE_GAIN (256 ,TEST_GSEL_256 ),GAIN_SCALE_GAIN (512 ,TEST_GSEL_512 ),GAIN_SCALE_GAIN (1024 ,TEST_GSEL_1024 ), -GAIN_SCALE_GAIN (2048 ,TEST_GSEL_2048 ),GAIN_SCALE_GAIN (4096 ,TEST_GSEL_4096 ), +GAIN_SCALE_GAIN (2048 ,TEST_GSEL_2048 ), #define HWGAIN_MAX 4096 };static const struct iio_itime_sel_mul gts_test_itimes[] = { -GAIN_SCALE_ITIME_US (400 *1000 ,TEST_TSEL_400 ,8 ), -GAIN_SCALE_ITIME_US (200 *1000 ,TEST_TSEL_200 ,4 ),GAIN_SCALE_ITIME_US (100 *1000 ,TEST_TSEL_100 ,2 ), +GAIN_SCALE_ITIME_US (400 *1000 ,TEST_TSEL_400 ,8 ), +GAIN_SCALE_ITIME_US (400 *1000 ,TEST_TSEL_400 ,8 ),GAIN_SCALE_ITIME_US (50 *1000 ,TEST_TSEL_50 ,1 ), +GAIN_SCALE_ITIME_US (200 *1000 ,TEST_TSEL_200 ,4 ), #define TIMEGAIN_MAX 8 };#define TOTAL_GAIN_MAX (HWGAIN_MAX * TIMEGAIN_MAX)
Signature · 14 lines
2.44.0 -- Matti Vaittinen, Linux device drivers ROHM Semiconductors, Finland SWDC Kiviharjunlenkki 1E 90220 OULU FINLAND ~~~ "I don't think so," said Rene Descartes. Just then he vanished ~~~ Simon says - in Latin please. ~~~ "non cogito me" dixit Rene Descarte, deinde evanescavit ~~~ Thanks to Simon Glass for the translation =]