docs/DeveloperPolicy.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
   2                       "http://www.w3.org/TR/html4/strict.dtd">
   3 <html>
   4 <head>
   5   <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
   6   <title>LLVM Developer Policy</title>
   7   <link rel="stylesheet" href="llvm.css" type="text/css">
   8 </head>
   9 <body>
  10
  11 <div class="doc_title">LLVM Developer Policy</div>
  12 <ol>
  13   <li><a href="#introduction">Introduction</a></li>
  14   <li><a href="#policies">Developer Policies</a>
  15   <ol>
  16     <li><a href="#informed">Stay Informed</a></li>
  17     <li><a href="#patches">Making a Patch</a></li>
  18     <li><a href="#reviews">Code Reviews</a></li>
  19     <li><a href="#owners">Code Owners</a></li>
  20     <li><a href="#testcases">Test Cases</a></li>
  21     <li><a href="#quality">Quality</a></li>
  22     <li><a href="#commitaccess">Obtaining Commit Access</a></li>
  23     <li><a href="#newwork">Making a Major Change</a></li>
  24     <li><a href="#incremental">Incremental Development</a></li>
  25     <li><a href="#attribution">Attribution of Changes</a></li>
  26   </ol></li>
  27   <li><a href="#clp">Copyright, License, and Patents</a>
  28   <ol>
  29     <li><a href="#copyright">Copyright</a></li>
  30     <li><a href="#license">License</a></li>
  31     <li><a href="#patents">Patents</a></li>
  32   </ol></li>
  33 </ol>
  34 <div class="doc_author">Written by the LLVM Oversight Team</div>
  35
  36 <!--=========================================================================-->
  37 <div class="doc_section"><a name="introduction">Introduction</a></div>
  38 <!--=========================================================================-->
  39 <div class="doc_text">
  40 <p>This document contains the LLVM Developer Policy which defines the project's
  41    policy towards developers and their contributions. The intent of this policy
  42    is to eliminate miscommunication, rework, and confusion that might arise from
  43    the distributed nature of LLVM's development.  By stating the policy in clear
  44    terms, we hope each developer can know ahead of time what to expect when
  45    making LLVM contributions.  This policy covers all llvm.org subprojects,
  46    including Clang, LLDB, etc.</p>
  47 <p>This policy is also designed to accomplish the following objectives:</p>
  48
  49 <ol>
  50   <li>Attract both users and developers to the LLVM project.</li>
  51
  52   <li>Make life as simple and easy for contributors as possible.</li>
  53
  54   <li>Keep the top of Subversion trees as stable as possible.</li>
  55 </ol>
  56
  57 <p>This policy is aimed at frequent contributors to LLVM. People interested in
  58    contributing one-off patches can do so in an informal way by sending them to
  59    the
  60    <a href="http://lists.cs.uiuc.edu/mailman/listinfo/llvm-commits">llvm-commits
  61    mailing list</a> and engaging another developer to see it through the
  62    process.</p>
  63 </div>
  64
  65 <!--=========================================================================-->
  66 <div class="doc_section"><a name="policies">Developer Policies</a></div>
  67 <!--=========================================================================-->
  68 <div class="doc_text">
  69 <p>This section contains policies that pertain to frequent LLVM developers.  We
  70    always welcome <a href="#patches">one-off patches</a> from people who do not
  71    routinely contribute to LLVM, but we expect more from frequent contributors
  72    to keep the system as efficient as possible for everyone.  Frequent LLVM
  73    contributors are expected to meet the following requirements in order for
  74    LLVM to maintain a high standard of quality.<p>
  75 </div>
  76
  77 <!-- _______________________________________________________________________ -->
  78 <div class="doc_subsection"> <a name="informed">Stay Informed</a> </div>
  79 <div class="doc_text">
  80 <p>Developers should stay informed by reading at least the "dev" mailing list
  81    for the projects you are interested in, such as
  82    <a href="http://lists.cs.uiuc.edu/mailman/listinfo/llvmdev">llvmdev</a> for
  83    LLVM, <a href="http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev">cfe-dev</a>
  84    for Clang, or <a
  85    href="http://lists.cs.uiuc.edu/mailman/listinfo/lldb-dev">lldb-dev</a>
  86    for LLDB.  If you are doing anything more than just casual work on LLVM, it
  87    is suggested that you also subscribe to the "commits" mailing list for the
  88    subproject you're interested in, such as
  89   <a href="http://lists.cs.uiuc.edu/mailman/listinfo/llvm-commits">llvm-commits</a>,
  90   <a href="http://lists.cs.uiuc.edu/mailman/listinfo/cfe-commits">cfe-commits</a>,
  91   or <a href="http://lists.cs.uiuc.edu/mailman/listinfo/lldb-commits">lldb-commits</a>.
  92    Reading the "commits" list and paying attention to changes being made by
  93    others is a good way to see what other people are interested in and watching
  94    the flow of the project as a whole.</p>
  95
  96 <p>We recommend that active developers register an email account with
  97    <a href="http://llvm.org/bugs/">LLVM Bugzilla</a> and preferably subscribe to
  98    the <a href="http://lists.cs.uiuc.edu/mailman/listinfo/llvmbugs">llvm-bugs</a>
  99    email list to keep track of bugs and enhancements occurring in LLVM.  We
 100    really appreciate people who are proactive at catching incoming bugs in their
 101    components and dealing with them promptly.</p>
 102 </div>
 103
 104 <!-- _______________________________________________________________________ -->
 105 <div class="doc_subsection"> <a name="patches">Making a Patch</a></div>
 106
 107 <div class="doc_text">
 108 <p>When making a patch for review, the goal is to make it as easy for the
 109    reviewer to read it as possible.  As such, we recommend that you:</p>
 110
 111 <ol>
 112   <li>Make your patch against the Subversion trunk, not a branch, and not an old
 113       version of LLVM.  This makes it easy to apply the patch.  For information
 114       on how to check out SVN trunk, please see the <a
 115       href="GettingStarted.html#checkout">Getting Started Guide</a>.</li>
 116
 117   <li>Similarly, patches should be submitted soon after they are generated.  Old
 118       patches may not apply correctly if the underlying code changes between the
 119       time the patch was created and the time it is applied.</li>
 120
 121   <li>Patches should be made with <tt>svn diff</tt>, or similar. If you use
 122       a different tool, make sure it uses the <tt>diff -u</tt> format and
 123       that it doesn't contain clutter which makes it hard to read.</li>
 124
 125   <li>If you are modifying generated files, such as the top-level
 126       <tt>configure</tt> script, please separate out those changes into
 127       a separate patch from the rest of your changes.</li>
 128 </ol>
 129
 130 <p>When sending a patch to a mailing list, it is a good idea to send it as an
 131    <em>attachment</em> to the message, not embedded into the text of the
 132    message.  This ensures that your mailer will not mangle the patch when it
 133    sends it (e.g. by making whitespace changes or by wrapping lines).</p>
 134
 135 <p><em>For Thunderbird users:</em> Before submitting a patch, please open
 136    <em>Preferences &#8594; Advanced &#8594; General &#8594; Config Editor</em>,
 137    find the key <tt>mail.content_disposition_type</tt>, and set its value to
 138    <tt>1</tt>. Without this setting, Thunderbird sends your attachment using
 139    <tt>Content-Disposition: inline</tt> rather than <tt>Content-Disposition:
 140    attachment</tt>. Apple Mail gamely displays such a file inline, making it
 141    difficult to work with for reviewers using that program.</p>
 142 </div>
 143
 144 <!-- _______________________________________________________________________ -->
 145 <div class="doc_subsection"> <a name="reviews">Code Reviews</a></div>
 146 <div class="doc_text">
 147 <p>LLVM has a code review policy. Code review is one way to increase the quality
 148    of software. We generally follow these policies:</p>
 149
 150 <ol>
 151   <li>All developers are required to have significant changes reviewed before
 152       they are committed to the repository.</li>
 153
 154   <li>Code reviews are conducted by email, usually on the llvm-commits
 155       list.</li>
 156
 157   <li>Code can be reviewed either before it is committed or after.  We expect
 158       major changes to be reviewed before being committed, but smaller changes
 159       (or changes where the developer owns the component) can be reviewed after
 160       commit.</li>
 161
 162   <li>The developer responsible for a code change is also responsible for making
 163       all necessary review-related changes.</li>
 164
 165   <li>Code review can be an iterative process, which continues until the patch
 166       is ready to be committed.</li>
 167 </ol>
 168
 169 <p>Developers should participate in code reviews as both reviewers and
 170    reviewees. If someone is kind enough to review your code, you should return
 171    the favor for someone else.  Note that anyone is welcome to review and give
 172    feedback on a patch, but only people with Subversion write access can approve
 173    it.</p>
 174 </div>
 175
 176 <!-- _______________________________________________________________________ -->
 177 <div class="doc_subsection"> <a name="owners">Code Owners</a></div>
 178 <div class="doc_text">
 179
 180 <p>The LLVM Project relies on two features of its process to maintain rapid
 181    development in addition to the high quality of its source base: the
 182    combination of code review plus post-commit review for trusted maintainers.
 183    Having both is a great way for the project to take advantage of the fact that
 184    most people do the right thing most of the time, and only commit patches
 185    without pre-commit review when they are confident they are right.</p>
 186
 187 <p>The trick to this is that the project has to guarantee that all patches that
 188    are committed are reviewed after they go in: you don't want everyone to
 189    assume someone else will review it, allowing the patch to go unreviewed.  To
 190    solve this problem, we have a notion of an 'owner' for a piece of the code.
 191    The sole responsibility of a code owner is to ensure that a commit to their
 192    area of the code is appropriately reviewed, either by themself or by someone
 193    else.  The current code owners are:</p>
 194
 195 <ol>
 196   <li><b>Evan Cheng</b>: Code generator and all targets.</li>
 197
 198   <li><b>Greg Clayton</b>: LLDB.</li>
 199
 200   <li><b>Doug Gregor</b>: Clang Frontend Libraries.</li>
 201
 202   <li><b>Howard Hinnant</b>: libc++.</li>
 203
 204   <li><b>Anton Korobeynikov</b>: Exception handling, debug information, and
 205       Windows codegen.</li>
 206
 207   <li><b>Ted Kremenek</b>: Clang Static Analyzer.</li>
 208
 209   <li><b>Chris Lattner</b>: Everything not covered by someone else.</li>
 210
 211   <li><b>Duncan Sands</b>: llvm-gcc 4.2.</li>
 212 </ol>
 213
 214 <p>Note that code ownership is completely different than reviewers: anyone can
 215    review a piece of code, and we welcome code review from anyone who is
 216    interested.  Code owners are the "last line of defense" to guarantee that all
 217    patches that are committed are actually reviewed.</p>
 218
 219 <p>Being a code owner is a somewhat unglamorous position, but it is incredibly
 220    important for the ongoing success of the project.  Because people get busy,
 221    interests change, and unexpected things happen, code ownership is purely
 222    opt-in, and anyone can choose to resign their "title" at any time. For now,
 223    we do not have an official policy on how one gets elected to be a code
 224    owner.</p>
 225 </div>
 226
 227 <!-- _______________________________________________________________________ -->
 228 <div class="doc_subsection"> <a name="testcases">Test Cases</a></div>
 229 <div class="doc_text">
 230 <p>Developers are required to create test cases for any bugs fixed and any new
 231    features added.  Some tips for getting your testcase approved:</p>
 232
 233 <ol>
 234   <li>All feature and regression test cases are added to the
 235       <tt>llvm/test</tt> directory. The appropriate sub-directory should be
 236       selected (see the <a href="TestingGuide.html">Testing Guide</a> for
 237       details).</li>
 238
 239   <li>Test cases should be written in <a href="LangRef.html">LLVM assembly
 240       language</a> unless the feature or regression being tested requires
 241       another language (e.g. the bug being fixed or feature being implemented is
 242       in the llvm-gcc C++ front-end, in which case it must be written in
 243       C++).</li>
 244
 245   <li>Test cases, especially for regressions, should be reduced as much as
 246       possible, by <a href="Bugpoint.html">bugpoint</a> or manually. It is
 247       unacceptable to place an entire failing program into <tt>llvm/test</tt> as
 248       this creates a <i>time-to-test</i> burden on all developers. Please keep
 249       them short.</li>
 250 </ol>
 251
 252 <p>Note that llvm/test and clang/test are designed for regression and small
 253    feature tests only. More extensive test cases (e.g., entire applications,
 254    benchmarks, etc)
 255    should be added to the <tt>llvm-test</tt> test suite.  The llvm-test suite is
 256    for coverage (correctness, performance, etc) testing, not feature or
 257    regression testing.</p>
 258 </div>
 259
 260 <!-- _______________________________________________________________________ -->
 261 <div class="doc_subsection"> <a name="quality">Quality</a></div>
 262 <div class="doc_text">
 263 <p>The minimum quality standards that any change must satisfy before being
 264    committed to the main development branch are:</p>
 265
 266 <ol>
 267   <li>Code must adhere to the <a href="CodingStandards.html">LLVM Coding
 268       Standards</a>.</li>
 269
 270   <li>Code must compile cleanly (no errors, no warnings) on at least one
 271       platform.</li>
 272
 273   <li>Bug fixes and new features should <a href="#testcases">include a
 274       testcase</a> so we know if the fix/feature ever regresses in the
 275       future.</li>
 276
 277   <li>Code must pass the <tt>llvm/test</tt> test suite.</li>
 278
 279   <li>The code must not cause regressions on a reasonable subset of llvm-test,
 280       where "reasonable" depends on the contributor's judgement and the scope of
 281       the change (more invasive changes require more testing). A reasonable
 282       subset might be something like
 283       "<tt>llvm-test/MultiSource/Benchmarks</tt>".</li>
 284 </ol>
 285
 286 <p>Additionally, the committer is responsible for addressing any problems found
 287    in the future that the change is responsible for.  For example:</p>
 288
 289 <ul>
 290   <li>The code should compile cleanly on all supported platforms.</li>
 291
 292   <li>The changes should not cause any correctness regressions in the
 293       <tt>llvm-test</tt> suite and must not cause any major performance
 294       regressions.</li>
 295
 296   <li>The change set should not cause performance or correctness regressions for
 297       the LLVM tools.</li>
 298
 299   <li>The changes should not cause performance or correctness regressions in
 300       code compiled by LLVM on all applicable targets.</li>
 301
 302   <li>You are expected to address any <a href="http://llvm.org/bugs/">bugzilla
 303       bugs</a> that result from your change.</li>
 304 </ul>
 305
 306 <p>We prefer for this to be handled before submission but understand that it
 307    isn't possible to test all of this for every submission.  Our build bots and
 308    nightly testing infrastructure normally finds these problems.  A good rule of
 309    thumb is to check the nightly testers for regressions the day after your
 310    change.  Build bots will directly email you if a group of commits that
 311    included yours caused a failure.  You are expected to check the build bot
 312    messages to see if they are your fault and, if so, fix the breakage.</p>
 313
 314 <p>Commits that violate these quality standards (e.g. are very broken) may be
 315    reverted. This is necessary when the change blocks other developers from
 316    making progress. The developer is welcome to re-commit the change after the
 317    problem has been fixed.</p>
 318 </div>
 319
 320 <!-- _______________________________________________________________________ -->
 321 <div class="doc_subsection">
 322   <a name="commitaccess">Obtaining Commit Access</a></div>
 323 <div class="doc_text">
 324
 325 <p>We grant commit access to contributors with a track record of submitting high
 326    quality patches.  If you would like commit access, please send an email to
 327    <a href="mailto:sabre@nondot.org">Chris</a> with the following
 328    information:</p>
 329
 330 <ol>
 331   <li>The user name you want to commit with, e.g. "hacker".</li>
 332
 333   <li>The full name and email address you want message to llvm-commits to come
 334       from, e.g. "J. Random Hacker &lt;hacker@yoyodyne.com&gt;".</li>
 335
 336   <li>A "password hash" of the password you want to use, e.g. "2ACR96qjUqsyM".
 337       Note that you don't ever tell us what your password is, you just give it
 338       to us in an encrypted form.  To get this, run "htpasswd" (a utility that
 339       comes with apache) in crypt mode (often enabled with "-d"), or find a web
 340       page that will do it for you.</li>
 341 </ol>
 342
 343 <p>Once you've been granted commit access, you should be able to check out an
 344    LLVM tree with an SVN URL of "https://username@llvm.org/..." instead of the
 345    normal anonymous URL of "http://llvm.org/...".  The first time you commit
 346    you'll have to type in your password.  Note that you may get a warning from
 347    SVN about an untrusted key, you can ignore this.  To verify that your commit
 348    access works, please do a test commit (e.g. change a comment or add a blank
 349    line).  Your first commit to a repository may require the autogenerated email
 350    to be approved by a mailing list.  This is normal, and will be done when
 351    the mailing list owner has time.</p>
 352
 353 <p>If you have recently been granted commit access, these policies apply:</p>
 354
 355 <ol>
 356   <li>You are granted <i>commit-after-approval</i> to all parts of LLVM.  To get
 357       approval, submit a <a href="#patches">patch</a> to
 358       <a href="http://lists.cs.uiuc.edu/mailman/listinfo/llvm-commits">llvm-commits</a>.
 359       When approved you may commit it yourself.</li>
 360
 361   <li>You are allowed to commit patches without approval which you think are
 362       obvious. This is clearly a subjective decision &mdash; we simply expect
 363       you to use good judgement.  Examples include: fixing build breakage,
 364       reverting obviously broken patches, documentation/comment changes, any
 365       other minor changes.</li>
 366
 367   <li>You are allowed to commit patches without approval to those portions of
 368       LLVM that you have contributed or maintain (i.e., have been assigned
 369       responsibility for), with the proviso that such commits must not break the
 370       build.  This is a "trust but verify" policy and commits of this nature are
 371       reviewed after they are committed.</li>
 372
 373   <li>Multiple violations of these policies or a single egregious violation may
 374       cause commit access to be revoked.</li>
 375 </ol>
 376
 377 <p>In any case, your changes are still subject to <a href="#reviews">code
 378    review</a> (either before or after they are committed, depending on the
 379    nature of the change).  You are encouraged to review other peoples' patches
 380    as well, but you aren't required to.</p>
 381 </div>
 382
 383 <!-- _______________________________________________________________________ -->
 384 <div class="doc_subsection"> <a name="newwork">Making a Major Change</a></div>
 385 <div class="doc_text">
 386 <p>When a developer begins a major new project with the aim of contributing it
 387    back to LLVM, s/he should inform the community with an email to
 388    the <a href="http://lists.cs.uiuc.edu/mailman/listinfo/llvmdev">llvmdev</a>
 389    email list, to the extent possible. The reason for this is to:
 390
 391 <ol>
 392   <li>keep the community informed about future changes to LLVM, </li>
 393
 394   <li>avoid duplication of effort by preventing multiple parties working on the
 395       same thing and not knowing about it, and</li>
 396
 397   <li>ensure that any technical issues around the proposed work are discussed
 398       and resolved before any significant work is done.</li>
 399 </ol>
 400
 401 <p>The design of LLVM is carefully controlled to ensure that all the pieces fit
 402    together well and are as consistent as possible. If you plan to make a major
 403    change to the way LLVM works or want to add a major new extension, it is a
 404    good idea to get consensus with the development community before you start
 405    working on it.</p>
 406
 407 <p>Once the design of the new feature is finalized, the work itself should be
 408    done as a series of <a href="#incremental">incremental changes</a>, not as a
 409    long-term development branch.</p>
 410 </div>
 411
 412 <!-- _______________________________________________________________________ -->
 413 <div class="doc_subsection"> <a name="incremental">Incremental Development</a>
 414 </div>
 415 <div class="doc_text">
 416 <p>In the LLVM project, we do all significant changes as a series of incremental
 417    patches.  We have a strong dislike for huge changes or long-term development
 418    branches.  Long-term development branches have a number of drawbacks:</p>
 419
 420 <ol>
 421   <li>Branches must have mainline merged into them periodically.  If the branch
 422       development and mainline development occur in the same pieces of code,
 423       resolving merge conflicts can take a lot of time.</li>
 424
 425   <li>Other people in the community tend to ignore work on branches.</li>
 426
 427   <li>Huge changes (produced when a branch is merged back onto mainline) are
 428       extremely difficult to <a href="#reviews">code review</a>.</li>
 429
 430   <li>Branches are not routinely tested by our nightly tester
 431       infrastructure.</li>
 432
 433   <li>Changes developed as monolithic large changes often don't work until the
 434       entire set of changes is done.  Breaking it down into a set of smaller
 435       changes increases the odds that any of the work will be committed to the
 436       main repository.</li>
 437 </ol>
 438
 439 <p>To address these problems, LLVM uses an incremental development style and we
 440    require contributors to follow this practice when making a large/invasive
 441    change.  Some tips:</p>
 442
 443 <ul>
 444   <li>Large/invasive changes usually have a number of secondary changes that are
 445       required before the big change can be made (e.g. API cleanup, etc).  These
 446       sorts of changes can often be done before the major change is done,
 447       independently of that work.</li>
 448
 449   <li>The remaining inter-related work should be decomposed into unrelated sets
 450       of changes if possible.  Once this is done, define the first increment and
 451       get consensus on what the end goal of the change is.</li>
 452
 453   <li>Each change in the set can be stand alone (e.g. to fix a bug), or part of
 454       a planned series of changes that works towards the development goal.</li>
 455
 456   <li>Each change should be kept as small as possible. This simplifies your work
 457       (into a logical progression), simplifies code review and reduces the
 458       chance that you will get negative feedback on the change. Small increments
 459       also facilitate the maintenance of a high quality code base.</li>
 460
 461   <li>Often, an independent precursor to a big change is to add a new API and
 462       slowly migrate clients to use the new API.  Each change to use the new API
 463       is often "obvious" and can be committed without review.  Once the new API
 464       is in place and used, it is much easier to replace the underlying
 465       implementation of the API.  This implementation change is logically
 466       separate from the API change.</li>
 467 </ul>
 468
 469 <p>If you are interested in making a large change, and this scares you, please
 470    make sure to first <a href="#newwork">discuss the change/gather consensus</a>
 471    then ask about the best way to go about making the change.</p>
 472 </div>
 473
 474 <!-- _______________________________________________________________________ -->
 475 <div class="doc_subsection"><a name="attribution">Attribution of
 476 Changes</a></div>
 477 <div class="doc_text">
 478 <p>We believe in correct attribution of contributions to their contributors.
 479    However, we do not want the source code to be littered with random
 480    attributions "this code written by J. Random Hacker" (this is noisy and
 481    distracting).  In practice, the revision control system keeps a perfect
 482    history of who changed what, and the CREDITS.txt file describes higher-level
 483    contributions.  If you commit a patch for someone else, please say "patch
 484    contributed by J. Random Hacker!" in the commit message.</p>
 485
 486 <p>Overall, please do not add contributor names to the source code.</p>
 487 </div>
 488
 489 <!--=========================================================================-->
 490 <div class="doc_section">
 491   <a name="clp">Copyright, License, and Patents</a>
 492 </div>
 493 <!--=========================================================================-->
 494
 495 <div class="doc_text">
 496 <p>This section addresses the issues of copyright, license and patents for the
 497    LLVM project.  Currently, the University of Illinois is the LLVM copyright
 498    holder and the terms of its license to LLVM users and developers is the
 499    <a href="http://www.opensource.org/licenses/UoI-NCSA.php">University of
 500    Illinois/NCSA Open Source License</a>.</p>
 501
 502 <div class="doc_notes">
 503 <p style="text-align:center;font-weight:bold">NOTE: This section deals with
 504    legal matters but does not provide legal advice.  We are not lawyers, please
 505    seek legal counsel from an attorney.</p>
 506 </div>
 507 </div>
 508
 509 <!-- _______________________________________________________________________ -->
 510 <div class="doc_subsection"><a name="copyright">Copyright</a></div>
 511 <div class="doc_text">
 512
 513 <p>The LLVM project does not require copyright assignments, which means that the
 514    copyright for the code in the project is held by its respective contributors
 515    who have each agreed to release their contributed code under the terms of the
 516    <a href="#license">LLVM License</a>.</p>
 517
 518 <p>An implication of this is that the LLVM license is unlikely to ever change:
 519    changing it would require tracking down all the contributors to LLVM and
 520    getting them to agree that a license change is acceptable for their
 521    contribution.  Since there are no plans to change the license, this is not a
 522    cause for concern.</p>
 523
 524 <p>As a contributor to the project, this means that you (or your company) retain
 525    ownership of the code you contribute, that it cannot be used in a way that
 526    contradicts the license (which is a liberal BSD-style license), and that the
 527    license for your contributions won't change without your approval in the
 528    future.</p>
 529
 530 </div>
 531
 532 <!-- _______________________________________________________________________ -->
 533 <div class="doc_subsection"><a name="license">License</a></div>
 534 <div class="doc_text">
 535 <p>We intend to keep LLVM perpetually open source and to use a liberal open
 536    source license. All of the code in LLVM is available under the
 537    <a href="http://www.opensource.org/licenses/UoI-NCSA.php">University of
 538    Illinois/NCSA Open Source License</a>, which boils down to this:</p>
 539
 540 <ul>
 541   <li>You can freely distribute LLVM.</li>
 542   <li>You must retain the copyright notice if you redistribute LLVM.</li>
 543   <li>Binaries derived from LLVM must reproduce the copyright notice (e.g. in an
 544       included readme file).</li>
 545   <li>You can't use our names to promote your LLVM derived products.</li>
 546   <li>There's no warranty on LLVM at all.</li>
 547 </ul>
 548
 549 <p>We believe this fosters the widest adoption of LLVM because it <b>allows
 550    commercial products to be derived from LLVM</b> with few restrictions and
 551    without a requirement for making any derived works also open source (i.e.
 552    LLVM's license is not a "copyleft" license like the GPL). We suggest that you
 553    read the <a href="http://www.opensource.org/licenses/UoI-NCSA.php">License</a>
 554    if further clarification is needed.</p>
 555
 556 <p>In addition to the UIUC license, the runtime library components of LLVM
 557    (<b>compiler_rt and libc++</b>) are also licensed under the <a
 558    href="http://www.opensource.org/licenses/mit-license.php">MIT license</a>,
 559    which does not contain the binary redistribution clause.  As a user of these
 560    runtime libraries, it means that you can choose to use the code under either
 561    license (and thus don't need the binary redistribution clause), and as a
 562    contributor to the code that you agree that any contributions to these
 563    libraries be licensed under both licenses.  We feel that this is important
 564    for runtime libraries, because they are implicitly linked into applications
 565    and therefore should not subject those applications to the binary
 566    redistribution clause. This also means that it is ok to move code from (e.g.)
 567    libc++ to the LLVM core without concern, but that code cannot be moved from
 568    the LLVM core to libc++ without the copyright owner's permission.
 569 </p>
 570
 571 <p>Note that the LLVM Project does distribute llvm-gcc, <b>which is GPL.</b>
 572    This means that anything "linked" into llvm-gcc must itself be compatible
 573    with the GPL, and must be releasable under the terms of the GPL.  This
 574    implies that <b>any code linked into llvm-gcc and distributed to others may
 575    be subject to the viral aspects of the GPL</b> (for example, a proprietary
 576    code generator linked into llvm-gcc must be made available under the GPL).
 577    This is not a problem for code already distributed under a more liberal
 578    license (like the UIUC license), and does not affect code generated by
 579    llvm-gcc.  It may be a problem if you intend to base commercial development
 580    on llvm-gcc without redistributing your source code.</p>
 581
 582 <p>We have no plans to change the license of LLVM.  If you have questions or
 583    comments about the license, please contact the
 584    <a href="mailto:llvmdev@cs.uiuc.edu">LLVM Developer's Mailing List</a>.</p>
 585 </div>
 586
 587 <!-- _______________________________________________________________________ -->
 588 <div class="doc_subsection"><a name="patents">Patents</a></div>
 589 <div class="doc_text">
 590 <p>To the best of our knowledge, LLVM does not infringe on any patents (we have
 591    actually removed code from LLVM in the past that was found to infringe).
 592    Having code in LLVM that infringes on patents would violate an important goal
 593    of the project by making it hard or impossible to reuse the code for
 594    arbitrary purposes (including commercial use).</p>
 595
 596 <p>When contributing code, we expect contributors to notify us of any potential
 597    for patent-related trouble with their changes.  If you or your employer own
 598    the rights to a patent and would like to contribute code to LLVM that relies
 599    on it, we require that the copyright owner sign an agreement that allows any
 600    other user of LLVM to freely use your patent.  Please contact
 601    the <a href="mailto:llvm-oversight@cs.uiuc.edu">oversight group</a> for more
 602    details.</p>
 603 </div>
 604
 605 <!-- *********************************************************************** -->
 606 <hr>
 607 <address>
 608   <a href="http://jigsaw.w3.org/css-validator/check/referer"><img
 609   src="http://jigsaw.w3.org/css-validator/images/vcss-blue" alt="Valid CSS"></a>
 610   <a href="http://validator.w3.org/check/referer"><img
 611   src="http://www.w3.org/Icons/valid-html401-blue" alt="Valid HTML 4.01"></a>
 612   Written by the
 613   <a href="mailto:llvm-oversight@cs.uiuc.edu">LLVM Oversight Group</a><br>
 614   <a href="http://llvm.org">The LLVM Compiler Infrastructure</a><br>
 615   Last modified: $Date$
 616 </address>
 617 </body>
 618 </html>