Skip to content

Commit f88f956

Browse files
committed
Implement debugging output of the bootstrap Step graph into a DOT file
1 parent 14b7b0b commit f88f956

File tree

1 file changed

+6
-0
lines changed

1 file changed

+6
-0
lines changed

src/building/bootstrapping/debugging-bootstrap.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -123,6 +123,12 @@ if [#96176][cleanup-compiler-for] is resolved.
123123

124124
[cleanup-compiler-for]: https://github.com/rust-lang/rust/issues/96176
125125

126+
### Rendering step graph
127+
128+
When you run bootstrap with the `BOOTSTRAP_TRACING` environment variable configured, bootstrap will automatically output a DOT file that shows all executed steps and their dependencies. The files will have a prefix `bootstrap-steps`. You can use e.g. `xdot` to visualize the file or e.g. `dot -Tsvg` to convert the DOT file to a SVG file.
129+
130+
A separate DOT file will be outputted for dry-run and non-dry-run execution.
131+
126132
### Using `tracing` in bootstrap
127133

128134
Both `tracing::*` macros and the `tracing::instrument` proc-macro attribute need to be gated behind `tracing` feature. Examples:

0 commit comments

Comments
 (0)