Go to file
David Gibson 15ad6d862e dtc: Automatically pick a sensible boot_cpuid_phys
Currently, when in -Idts -Odtb or -Ifs -Odtb modes, dtc always
defaults to using 0 as the value for the boot_cpuid_phys header field.
That's correct quite often, but there are some systems where there is
no CPU with hardware ID of 0, or where we don't want to use the CPU
with hardware ID 0 at all (e.g. for AMP-style partitioning).  The only
way to override this default currently, is with the -b command line
option.

This patch improves dtc to instead base the default boot_cpuid_phys
value on the reg property of the first listed subnode of /cpus.  This
means that dtc will get boot_cpuid_phys correct by default in a
greater proportion of cases (since the boot cpu is usually listed
first, and this way at least the boot_cpuid_phys default will match
some existing cpu node).  If the node doesn't exist or has an invalid
'reg' property (missing or not 4 bytes in length), then
boot_cpuid_phys is set to 0.

Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
2010-02-19 08:36:23 -06:00
Documentation Some Documentation fixes and generalizations. 2008-10-03 09:42:26 -05:00
libfdt Support ePAPR compliant phandle properties 2009-11-26 15:06:17 -06:00
scripts Add DTC release version information. 2007-07-07 13:52:25 -05:00
tests dtc: Automatically pick a sensible boot_cpuid_phys 2010-02-19 08:36:23 -06: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 add Mac OS X support 2009-07-15 21:30:14 -05:00
Makefile.convert-dtsv0 Implement and use an xstrdup() function 2008-10-03 11:12:33 -05:00
Makefile.dtc Implement and use an xstrdup() function 2008-10-03 11:12:33 -05:00
Makefile.ftdump Rearrange ftdump and convert-dtsv0 into sub-Makefiles. 2008-10-03 10:50:28 -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 Support ePAPR compliant phandle properties 2009-11-26 15:06:17 -06:00
convert-dtsv0-lexer.l dtc: Simpler interface to source file management 2010-01-14 07:52:25 -06:00
data.c dtc: Make many functions 'static' 2008-08-13 13:04:39 -05:00
dtc-lexer.l Modification of lexer and parser, improving dtc portability. 2010-02-08 09:29:52 -06:00
dtc-parser.y dtc: Automatically pick a sensible boot_cpuid_phys 2010-02-19 08:36:23 -06:00
dtc.c dtc: Simpler interface to source file management 2010-01-14 07:52:25 -06:00
dtc.h dtc: Automatically pick a sensible boot_cpuid_phys 2010-02-19 08:36:23 -06:00
flattree.c dtc: Simpler interface to source file management 2010-01-14 07:52:25 -06:00
fstree.c dtc: Automatically pick a sensible boot_cpuid_phys 2010-02-19 08:36:23 -06:00
ftdump.c Assorted cleanups and extensions for ftdump 2009-11-17 08:09:04 -06:00
livetree.c dtc: Automatically pick a sensible boot_cpuid_phys 2010-02-19 08:36:23 -06:00
srcpos.c dtc: Cleanup YYLTYPE and YYLLOC_DEFAULT declarations 2010-01-14 07:53:00 -06:00
srcpos.h dtc: Cleanup YYLTYPE and YYLLOC_DEFAULT declarations 2010-01-14 07:53:00 -06:00
treesource.c dtc: Simpler interface to source file management 2010-01-14 07:52:25 -06:00
util.c dtc: Simpler interface to source file management 2010-01-14 07:52:25 -06:00
util.h dtc: Simpler interface to source file management 2010-01-14 07:52:25 -06: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