vsprintf: Add %p extension "%pOF" for device tree
authorPantelis Antoniou <pantelis.antoniou@konsulko.com>
Wed, 21 Jan 2015 17:06:14 +0000 (19:06 +0200)
committerRob Herring <robh@kernel.org>
Tue, 27 Jun 2017 17:36:40 +0000 (12:36 -0500)
commitce4fecf1fe1518131ff80eebf412de0080fea049
treece6ebedb494bf08a0375050fe4077f2e1dbcb71c
parent27497e11b56a072dfd80e9f1f229049b2921a1a6
vsprintf: Add %p extension "%pOF" for device tree

90% of the usage of device node's full_name is printing it out in a
kernel message. However, storing the full path for every node is
wasteful and redundant. With a custom format specifier, we can generate
the full path at run-time and eventually remove the full path from every
node.

For instance typical use is:
pr_info("Frobbing node %s\n", node->full_name);

Which can be written now as:
pr_info("Frobbing node %pOF\n", node);

'%pO' is the base specifier to represent kobjects with '%pOF'
representing struct device_node. Currently, struct device_node is the
only supported type of kobject.

More fine-grained control of formatting includes printing the name,
flags, path-spec name and others, explained in the documentation entry.

Originally written by Pantelis, but pretty much rewrote the core
function using existing string/number functions. The 2 passes were
unnecessary and have been removed. Also, updated the checkpatch.pl
check. The unittest code was written by Grant Likely.

Signed-off-by: Pantelis Antoniou <pantelis.antoniou@konsulko.com>
Acked-by: Joe Perches <joe@perches.com>
Signed-off-by: Rob Herring <robh@kernel.org>
Documentation/printk-formats.txt
drivers/of/unittest-data/tests-platform.dtsi
drivers/of/unittest.c
lib/vsprintf.c
scripts/checkpatch.pl