diff options
Diffstat (limited to 'documentation/getting-started/eclipse/html/getting-started/usingpoky-specifying-LIC_FILES_CHKSUM.html')
| -rw-r--r-- | documentation/getting-started/eclipse/html/getting-started/usingpoky-specifying-LIC_FILES_CHKSUM.html | 82 |
1 files changed, 82 insertions, 0 deletions
diff --git a/documentation/getting-started/eclipse/html/getting-started/usingpoky-specifying-LIC_FILES_CHKSUM.html b/documentation/getting-started/eclipse/html/getting-started/usingpoky-specifying-LIC_FILES_CHKSUM.html new file mode 100644 index 0000000000..ed9a3cc501 --- /dev/null +++ b/documentation/getting-started/eclipse/html/getting-started/usingpoky-specifying-LIC_FILES_CHKSUM.html | |||
| @@ -0,0 +1,82 @@ | |||
| 1 | <html> | ||
| 2 | <head> | ||
| 3 | <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | ||
| 4 | <title>3.7.1.1. Specifying the LIC_FILES_CHKSUM Variable</title> | ||
| 5 | <link rel="stylesheet" type="text/css" href="../book.css"> | ||
| 6 | <meta name="generator" content="DocBook XSL Stylesheets V1.76.1"> | ||
| 7 | <link rel="home" href="index.html" title="Getting Started With Yocto Project"> | ||
| 8 | <link rel="up" href="usingpoky-configuring-LIC_FILES_CHKSUM.html" title="3.7.1. Tracking License Changes"> | ||
| 9 | <link rel="prev" href="usingpoky-configuring-LIC_FILES_CHKSUM.html" title="3.7.1. Tracking License Changes"> | ||
| 10 | <link rel="next" href="usingpoky-LIC_FILES_CHKSUM-explanation-of-syntax.html" title="3.7.1.2. Explanation of Syntax"> | ||
| 11 | </head> | ||
| 12 | <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="section" title="3.7.1.1. Specifying the LIC_FILES_CHKSUM Variable"> | ||
| 13 | <div class="titlepage"><div><div><h4 class="title"> | ||
| 14 | <a name="usingpoky-specifying-LIC_FILES_CHKSUM"></a>3.7.1.1. Specifying the <code class="filename">LIC_FILES_CHKSUM</code> Variable</h4></div></div></div> | ||
| 15 | <p> | ||
| 16 | The <code class="filename">LIC_FILES_CHKSUM</code> | ||
| 17 | variable contains checksums of the license text in the | ||
| 18 | source code for the recipe. | ||
| 19 | Following is an example of how to specify | ||
| 20 | <code class="filename">LIC_FILES_CHKSUM</code>: | ||
| 21 | </p> | ||
| 22 | <pre class="literallayout"> | ||
| 23 | LIC_FILES_CHKSUM = "file://COPYING;md5=xxxx \ | ||
| 24 | file://licfile1.txt;beginline=5;endline=29;md5=yyyy \ | ||
| 25 | file://licfile2.txt;endline=50;md5=zzzz \ | ||
| 26 | ..." | ||
| 27 | </pre> | ||
| 28 | <p> | ||
| 29 | </p> | ||
| 30 | <div class="note" title="Notes" style="margin-left: 0.5in; margin-right: 0.5in;"> | ||
| 31 | <h3 class="title">Notes</h3> | ||
| 32 | <div class="itemizedlist"><ul class="itemizedlist" type="disc"> | ||
| 33 | <li class="listitem"><p> | ||
| 34 | When using "beginline" and "endline", realize | ||
| 35 | that line numbering begins with one and not | ||
| 36 | zero. | ||
| 37 | Also, the included lines are inclusive (i.e. | ||
| 38 | lines five through and including 29 in the | ||
| 39 | previous example for | ||
| 40 | <code class="filename">licfile1.txt</code>). | ||
| 41 | </p></li> | ||
| 42 | <li class="listitem"><p> | ||
| 43 | When a license check fails, the selected license | ||
| 44 | text is included as part of the QA message. | ||
| 45 | Using this output, you can determine the exact | ||
| 46 | start and finish for the needed license text. | ||
| 47 | </p></li> | ||
| 48 | </ul></div> | ||
| 49 | </div> | ||
| 50 | <p> | ||
| 51 | </p> | ||
| 52 | <p> | ||
| 53 | The build system uses the | ||
| 54 | <a class="link" href="../ref-manual/var-S.html" target="_self"><code class="filename">S</code></a> | ||
| 55 | variable as the default directory when searching files | ||
| 56 | listed in <code class="filename">LIC_FILES_CHKSUM</code>. | ||
| 57 | The previous example employs the default directory. | ||
| 58 | </p> | ||
| 59 | <p> | ||
| 60 | Consider this next example: | ||
| 61 | </p> | ||
| 62 | <pre class="literallayout"> | ||
| 63 | LIC_FILES_CHKSUM = "file://src/ls.c;beginline=5;endline=16;\ | ||
| 64 | md5=bb14ed3c4cda583abc85401304b5cd4e" | ||
| 65 | LIC_FILES_CHKSUM = "file://${WORKDIR}/license.html;md5=5c94767cedb5d6987c902ac850ded2c6" | ||
| 66 | </pre> | ||
| 67 | <p> | ||
| 68 | </p> | ||
| 69 | <p> | ||
| 70 | The first line locates a file in | ||
| 71 | <code class="filename">${S}/src/ls.c</code> and isolates lines five | ||
| 72 | through 16 as license text. | ||
| 73 | The second line refers to a file in | ||
| 74 | <a class="link" href="../ref-manual/var-WORKDIR.html" target="_self"><code class="filename">WORKDIR</code></a>. | ||
| 75 | </p> | ||
| 76 | <p> | ||
| 77 | Note that <code class="filename">LIC_FILES_CHKSUM</code> variable is | ||
| 78 | mandatory for all recipes, unless the | ||
| 79 | <code class="filename">LICENSE</code> variable is set to "CLOSED". | ||
| 80 | </p> | ||
| 81 | </div></body> | ||
| 82 | </html> | ||