Go to file
David Gibson cb650ae143 libfdt: Implement fdt_get_property_namelen() and fdt_getprop_namelen()
As well as fdt_subnode_offset(), libfdt includes an
fdt_subnode_offset_namelen() function that takes the subnode name to
look up not as a NUL-terminated string, but as a string with an
explicit length.  This can be useful when the caller has the name as
part of a longer string, such as a full path.

However, we don't have corresponding 'namelen' versions for
fdt_get_property() and fdt_getprop().  There are less obvious use
cases for these variants on property names, but there are
circumstances where they can be useful e.g. looking up property names
which need to be parsed from a longer string buffer such as user input
or a configuration file, or looking up an alias in a path with
IEEE1275 style aliases.

So, since it's very easy to implement such variants, this patch does
so.  The original NUL-terminated variants are, of course, implemented
in terms of the namelen versions.

Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
2008-08-13 13:06:01 -05:00
Documentation dtc: Add some documentation for the dts formta 2008-03-23 08:00:33 -05:00
libfdt libfdt: Implement fdt_get_property_namelen() and fdt_getprop_namelen() 2008-08-13 13:06:01 -05:00
scripts Add DTC release version information. 2007-07-07 13:52:25 -05:00
tests dtc: Make many functions 'static' 2008-08-13 13:04:39 -05:00
.gitignore Merge libfdt into dtc. 2007-06-14 15:05:55 +10:00
GPL dtc: Remove redundant copy of the GPL 2007-06-25 21:43:11 -05:00
Makefile Tag Version 1.2.0 2008-07-25 16:17:04 -05:00
Makefile.dtc dtc: Clean up included Makefile fragments 2008-05-19 14:07:53 -05:00
README.license dtc/libfdt: Add README clarifying licensing 2008-01-04 08:37:36 -06:00
TODO dtc: Update TODO files 2007-12-19 08:20:26 -06:00
checks.c dtc: Run relevant checks on dtb input as well as dts 2008-07-14 12:36:08 -05:00
convert-dtsv0-lexer.l dtc: Clean up lexing of include files 2008-07-14 12:21:24 -05:00
data.c dtc: Make many functions 'static' 2008-08-13 13:04:39 -05:00
dtc-lexer.l dtc: Remove unused lexer function 2008-07-31 10:37:45 -05:00
dtc-parser.y dtc: Use stdint.h types throughout dtc 2008-07-14 12:07:19 -05:00
dtc.c dtc: give advance warning that "-S" is going away. 2008-07-31 10:38:10 -05:00
dtc.h dtc: Use the same endian-conversion functions as libfdt 2008-07-14 12:07:22 -05:00
flattree.c dtc: Use the same endian-conversion functions as libfdt 2008-07-14 12:07:22 -05:00
fstree.c dtc: Rework handling of boot_cpuid_phys 2008-05-19 14:12:15 -05:00
ftdump.c dtc: Enable and fix -Wcast-qual warnings 2008-07-14 12:36:08 -05:00
livetree.c dtc: Run relevant checks on dtb input as well as dts 2008-07-14 12:36:08 -05:00
srcpos.c dtc: Make dtc_open_file() die() if unable to open requested file 2008-03-23 08:00:33 -05:00
srcpos.h dtc: Remove ugly include stack abuse 2008-03-23 08:00:33 -05:00
treesource.c dtc: Make many functions 'static' 2008-08-13 13:04:39 -05:00

README.license

Licensing and contribution policy of dtc and libfdt
===================================================

This dtc package contains two pieces of software: dtc itself, and
libfdt which comprises the files in the libfdt/ subdirectory.  These
two pieces of software, although closely related, are quite distinct.
dtc does not incoporate or rely on libfdt for its operation, nor vice
versa.  It is important that these two pieces of software have
different license conditions.

As the copyright banners in each source file attest, dtc is licensed
under the GNU GPL.  The full text of the GPL can be found in the file
entitled 'GPL' which should be included in this package.  dtc code,
therefore, may not be incorporated into works which do not have a GPL
compatible license.

libfdt, however, is GPL/BSD dual-licensed.  That is, it may be used
either under the terms of the GPL, or under the terms of the 2-clause
BSD license (aka the ISC license).  The full terms of that license are
given in the copyright banners of each of the libfdt source files.
This is, in practice, equivalent to being BSD licensed, since the
terms of the BSD license are strictly more permissive than the GPL.

I made the decision to license libfdt in this way because I want to
encourage widespread and correct usage of flattened device trees,
including by proprietary or otherwise GPL-incompatible firmware or
tools.  Allowing libfdt to be used under the terms of the BSD license
makes that it easier for vendors or authors of such software to do so.

This does mean that libfdt code could be "stolen" - say, included in a
proprietary fimware and extended without contributing those extensions
back to the libfdt mainline.  While I hope that doesn't happen, I
believe the goal of allowing libfdt to be widely used is more
important than avoiding that.  libfdt is quite small, and hardly
rocket science; so the incentive for such impolite behaviour is small,
and the inconvenience caused therby is not dire.

Licenses such as the LGPL which would allow code to be used in non-GPL
software, but also require contributions to be returned were
considered.  However, libfdt is designed to be used in firmwares and
other environments with unusual technical constraints.  It's difficult
to anticipate all possible changes which might be needed to meld
libfdt into such environments and so difficult to suitably word a
license that puts the boundary between what is and isn't permitted in
the intended place.  Again, I judged encouraging widespread use of
libfdt by keeping the license terms simple and familiar to be the more
important goal.

**IMPORTANT** It's intended that all of libfdt as released remain
permissively licensed this way.  Therefore only contributions which
are released under these terms can be merged into the libfdt mainline.


David Gibson <david@gibson.dropbear.id.au>
(principal original author of dtc and libfdt)
2 November 2007