diff options
author | Trevor Woerner <twoerner@gmail.com> | 2025-09-18 17:27:28 -0400 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2025-09-22 22:09:48 +0100 |
commit | 141a6f905da3b04a2a5adf1358ac50a6dd34c1ea (patch) | |
tree | 5645f2ea8d97ace8108a82d16cd95f6267d815b5 | |
parent | 9cfbed3d27b0671c562dfa6ef17bb8d2f9ccde49 (diff) | |
download | poky-141a6f905da3b04a2a5adf1358ac50a6dd34c1ea.tar.gz |
patchtest.README: update host mode section
Update the "Host Mode" section to provide more detail and exact steps
assuming the user is using a previously- or just-installed patchtest
following the steps outlined in the "Installation" section above in the
same document.
(From OE-Core rev: 29402e3fdf161b348ba6c01d3994bdf96a9e3d95)
Signed-off-by: Trevor Woerner <twoerner@gmail.com>
Signed-off-by: Mathieu Dubois-Briand <mathieu.dubois-briand@bootlin.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
-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 | ||