Skip to content

Commit

Permalink
docs: add more information regarding --use-new-run (#2687)
Browse files Browse the repository at this point in the history
  • Loading branch information
aaron-prindle authored Aug 18, 2023
1 parent 6ee84f1 commit 8a0af16
Showing 1 changed file with 6 additions and 2 deletions.
8 changes: 6 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -1068,8 +1068,12 @@ Set this flag to indicate which build stage is the target build stage.

#### Flag `--use-new-run`

Use the experimental run implementation for detecting changes without requiring
file system snapshots. In some cases, this may improve build performance by 75%.
Use the experimental RUN implementation for detecting changes without requiring
Using this flag enables an experimental implementation of the Run command which does not rely on snapshotting at all.
In this approach, in order to compute which files were changed, a marker file is created before executing the Run command.
Then the entire filesystem is walked (takes ~1-3 seconds for 700Kfiles) to find all files whose ModTime is greater than the marker file.
With this new run command implementation, the total build time is reduced seeing performance improvements in the range of ~75%. This new run mode trades
off accuracy/correctness in some cases (potential for missed files in "snapshot") for improved performance by avoiding the full filesystem snapshots.

#### Flag `--verbosity`

Expand Down

0 comments on commit 8a0af16

Please sign in to comment.