Skip to content

Add a couple of string-related functions

Thierry Reding devicetree-compiler 3 versions – In review

Get series with b4
b4 am [email protected]

Versions newest first · linked by author and title

  1. v3 Latest3 patches 5 repliesIn review
  2. v23 patches 7 repliesSuperseded
  3. v13 patches 11 repliesSuperseded

Changes in v3 from the cover letter

- Rename functions and rework prototypes to be more in line with the existing API.
- Remove shortcut for fdt_stringlist_get() with index 0 to discourage users from taking shortcuts when parsing lists of strings.

Patches in v3 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/3fdt: Add a function to count stringslibfdt/fdt_ro.c libfdt/libfdt.h tests/.gitignore +4 more+142 -10 replies
2/3fdt: Add a function to get the index of a stringlibfdt/fdt_ro.c libfdt/libfdt.h tests/strings.c+92 -00 replies
3/3fdt: Add functions to retrieve stringslibfdt/fdt_ro.c libfdt/libfdt.h tests/strings.c+105 -00 replies

Reviews trailers per patch

No Reviewed-by, Acked-by or Tested-by trailers for v3 yet.

Read the v3 thread

Cover letter [PATCH v3 0/3] Add a couple of string-related functions

From: Thierry Reding <[email protected]>

These three patches add a couple of string functions that have proven useful in U-Boot's copy of libfdt, so they are likely to be useful for other users as well.

Patch 1 adds a function to count the number of strings in a property's value. This also adds a new DTS sample along with a small test program to validate the implemented functions.

Patch 2 adds a function to retrieve the index of a given string in any given property's value. This adds code to the test program introduced in the previous patch to exercise the new functionality.

Patch 3 adds a function to retrieve a string by index from a property's value. This extends the test program introduced in patch 1 to validate the new functionality.

Changes in v3:
- Rename functions and rework prototypes to be more in line with the existing API.
- Remove shortcut for fdt_stringlist_get() with index 0 to discourage users from taking shortcuts when parsing lists of strings.

Changes in v2:
- Safely handle non-NUL-terminated values. Uses strnlen() instead of strlen() to restrict accesses to the property value.
- Return FDT_ERR_BADVALUE if a non-NUL-terminated value is detected. Note that for performance reasons this doesn't always work. Cell or byte properties can look very much like NUL-terminated strings. The fdt_find_string() and fdt_get_string_index() functions can return a valid index or string, respectively, because they don't look at the complete value to determine validity. This could of course be fixed but the cases in which this succeeds the user did ask for trouble, so I didn't think it worth the extra effort.
- Improve documentation and tests.

Thierry Reding (3):
fdt: Add a function to count strings
fdt: Add a function to get the index of a string
fdt: Add functions to retrieve strings

 libfdt/fdt_ro.c      | 100 +++++++++++++++++++++++++++++++++
 libfdt/libfdt.h      |  69 ++++++++++++++++++++++-
 tests/.gitignore     |   1 +
 tests/Makefile.tests |   1 +
 tests/run_tests.sh   |   3 +
 tests/strings.c      | 154 +++++++++++++++++++++++++++++++++++++++++++++++++++
 tests/strings.dts    |  12 ++++
 7 files changed, 339 insertions(+), 1 deletion(-)
 create mode 100644 tests/strings.c
 create mode 100644 tests/strings.dts
Signature · 1 line
2.5.0