From 4d09a83420df9b971415133b1904bcd9cc4f6fdd Mon Sep 17 00:00:00 2001 From: Simon Glass Date: Wed, 6 Jun 2018 12:33:32 -0600 Subject: [PATCH] fdtput: Add documentation This is missing at present and the fdtput tool could use a litle more information than just its help text. This might be useful for distributions which want to provide a man page. Signed-off-by: Simon Glass Signed-off-by: David Gibson --- Documentation/manual.txt | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/Documentation/manual.txt b/Documentation/manual.txt index af8d315..6898caa 100644 --- a/Documentation/manual.txt +++ b/Documentation/manual.txt @@ -724,3 +724,36 @@ where options are: If -t is not provided, fdtget will try to figure out the type, trying to detect strings, string lists and the size of each value in the property. This is similar to how fdtdump works, and uses the same heuristics. + + +5 ) fdtput - Write properties to a device tree + +The syntax of the fdtput command is: + + fdtput
[...] + fdtput -c
[...] + fdtput -r
[...] + fdtput -d
[...] + +Options are: + + s=string, i=int, u=unsigned, x=hex + Optional modifier prefix: + hh or b=byte, h=2 byte, l=4 byte (default) + + -c, --create Create nodes if they don't already exist + -r, --remove Delete nodes (and any subnodes) if they already exist + -d, --delete Delete properties if they already exist + -p, --auto-path Automatically create nodes as needed for the node path + -t, --type Type of data + -v, --verbose Display each value decoded from command line + -h, --help Print this help and exit + -V, --version Print version and exit + +The option determines which usage is selected and therefore the operation that +is performed. The first usage adds or updates properties; the rest are used to +create/delete nodes and delete properties. + +For the first usage, the command line arguments are joined together into a +single value which is written to the property. The -t option is required so +that fdtput knows how to decode its arguments.