diff options
Diffstat (limited to 'scripts/patchtest.README')
-rw-r--r-- | scripts/patchtest.README | 39 |
1 files changed, 27 insertions, 12 deletions
diff --git a/scripts/patchtest.README b/scripts/patchtest.README index b321d8e47c..30f7538529 100644 --- a/scripts/patchtest.README +++ b/scripts/patchtest.README | |||
@@ -181,27 +181,42 @@ storage formats. | |||
181 | 181 | ||
182 | ### Host Mode | 182 | ### Host Mode |
183 | 183 | ||
184 | To run patchtest on the host, do the following: | 184 | To run patchtest in "host" mode, do the following: |
185 | 185 | ||
186 | 1. In openembedded-core/poky, do `source oe-init-build-env` | 186 | 1. Using openembedded-core or poky, do the following if re-using the |
187 | 2. Generate patch files from the target repository by doing `git format-patch -N`, | 187 | installation given in the installation procedure above: |
188 | where N is the number of patches starting at HEAD, or by using git-pw | ||
189 | or patchtest-get-series | ||
190 | 3. Run patchtest on a patch file by doing the following: | ||
191 | 188 | ||
192 | patchtest --patch /path/to/patch/file | 189 | $ . yocto/openembedded-core/oe-init-build-env build yocto/bitbake |
190 | |||
191 | or | ||
192 | |||
193 | $ . yocto/poky/oe-init-build-env | ||
194 | |||
195 | 2. Activate the Python virtual environment that was created using the | ||
196 | steps from the installation procedure given above: | ||
197 | |||
198 | $ . patchtest.venv/bin/activate | ||
199 | |||
200 | 3. Obtain one or more patches (see section above) | ||
201 | |||
202 | 4. Run patchtest on a patch file by doing the following: | ||
203 | |||
204 | (patchtest.venv) $ patchtest --patch /path/to/patch/file | ||
193 | 205 | ||
194 | or, if you have stored the patch files in a directory, do: | 206 | or, if you have stored the patch files in a directory, do: |
195 | 207 | ||
196 | patchtest --directory /path/to/patch/directory | 208 | (patchtest.venv) $ patchtest --directory /path/to/patch/directory |
197 | 209 | ||
198 | For example, to test `master-gcc-Fix--fstack-protector-issue-on-aarch64.patch` against the oe-core test suite: | 210 | For example, to test |
211 | `master-gcc-Fix--fstack-protector-issue-on-aarch64.patch` against the | ||
212 | oe-core test suite: | ||
199 | 213 | ||
200 | patchtest --patch master-gcc-Fix--fstack-protector-issue-on-aarch64.patch | 214 | (patchtest.venv) $ patchtest --patch master-gcc-Fix--fstack-protector-issue-on-aarch64.patch |
201 | 215 | ||
202 | If you want to use a different test suite or target repository, you can use the --testdir and --repodir flags: | 216 | If you want to use a different test suite or target repository, you |
217 | can use the --testdir and --repodir flags: | ||
203 | 218 | ||
204 | patchtest --patch /path/to/patch/file --repodir /path/to/repo --testdir /path/to/test/dir | 219 | (patchtest.venv) $ patchtest --patch /path/to/patch/file --repodir /path/to/repo --testdir /path/to/test/dir |
205 | 220 | ||
206 | ### Guest Mode | 221 | ### Guest Mode |
207 | 222 | ||