Skip to content

Commit f874356

Browse files
authored
Rollup merge of #145490 - Kobzol:bootstrap-io-tracing, r=jieyouxu
Trace some basic I/O operations in bootstrap When working on removing the rmeta sysroot copies, it is quite difficult to figure out *why* was did a certain file appear in a given directory. This should help with that a bit. r? `@jieyouxu`
2 parents fe1aaa3 + 4aec8be commit f874356

File tree

1 file changed

+5
-3
lines changed

1 file changed

+5
-3
lines changed

src/building/bootstrapping/debugging-bootstrap.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -81,9 +81,11 @@ There are two orthogonal ways to control which kind of tracing logs you want:
8181
- If you select a level, all events/spans with an equal or higher priority level will be shown.
8282
2. You can also control the log **target**, e.g. `bootstrap` or `bootstrap::core::config` or a custom target like `CONFIG_HANDLING` or `STEP`.
8383
- Custom targets are used to limit what kinds of spans you are interested in, as the `BOOTSTRAP_TRACING=trace` output can be quite verbose. Currently, you can use the following custom targets:
84-
- `CONFIG_HANDLING`: show spans related to config handling
85-
- `STEP`: show all executed steps. Note that executed commands have `info` event level.
86-
- `COMMAND`: show all executed commands. Note that executed commands have `trace` event level.
84+
- `CONFIG_HANDLING`: show spans related to config handling.
85+
- `STEP`: show all executed steps. Executed commands have `info` event level.
86+
- `COMMAND`: show all executed commands. Executed commands have `trace` event level.
87+
- `IO`: show performed I/O operations. Executed commands have `trace` event level.
88+
- Note that many I/O are currently not being traced.
8789

8890
You can of course combine them (custom target logs are typically gated behind `TRACE` log level additionally):
8991

0 commit comments

Comments
 (0)