From: Gerald Van Baren <vanbaren@cideas.com>
Date: Fri, 22 Aug 2008 18:37:05 +0000 (-0400)
Subject: Add note on dereferencing /aliases pointers
X-Git-Tag: v2008.10-rc1~124
X-Git-Url: https://git.librecmc.org/?a=commitdiff_plain;h=109c30fb8edea1a15d37a6ce787cd5faf33d8e43;p=oweals%2Fu-boot.git

Add note on dereferencing /aliases pointers

Replace the "must quote special characters" note with a hint on
how to dereference /aliases pointers by omitting the leading "/".
This feature was introduced by Kumar Gala as a libfdt enhancement
in commit ed035708235332c3c117ee3bb1a426063f03cfcb.

Example:

=> fdt print /aliases
aliases {
        ethernet0 = "/qe@e0100000/ucc@2000";
        ethernet1 = "/qe@e0100000/ucc@3000";
        serial0 = "/soc8360@e0000000/serial@4500";
        serial1 = "/soc8360@e0000000/serial@4600";
        pci0 = "/pci@e0008500";
};
=> fdt print ethernet0
ucc@2000 {
        device_type = "network";
        compatible = "ucc_geth";
        cell-index = <0x1>;
        reg = <0x2000 0x200>;
        interrupts = <0x20>;
        interrupt-parent = <0x2>;
        local-mac-address = [00 00 00 00 00 00];
        rx-clock-name = "none";
        tx-clock-name = "clk9";
        phy-handle = <0x3>;
        phy-connection-type = "rgmii-id";
        pio-handle = <0x4>;
};

Signed-off-by: Gerald Van Baren <vanbaren@cideas.com>
---

diff --git a/common/cmd_fdt.c b/common/cmd_fdt.c
index c129993a91..94bca4646a 100644
--- a/common/cmd_fdt.c
+++ b/common/cmd_fdt.c
@@ -820,6 +820,6 @@ U_BOOT_CMD(
 	"fdt rsvmem delete <index>           - Delete a mem reserves\n"
 	"fdt chosen [<start> <end>]          - Add/update the /chosen branch in the tree\n"
 	"                                        <start>/<end> - initrd start/end addr\n"
-	"NOTE: If the path or property you are setting/printing has a '#' character\n"
-	"     or spaces, you MUST escape it with a \\ character or quote it with \".\n"
+	"NOTE: Dereference aliases by omiting the leading '/', "
+		"e.g. fdt print ethernet0.\n"
 );