Skip to content

Insert write-back copy_ nodes at the earliest safe point - #20744

Open
JPL11 wants to merge 13 commits into
pytorch:mainfrom
JPL11:early-write-back-copies
Open

JPL11 wants to merge 13 commits into
pytorch:mainfrom
JPL11:early-write-back-copies

Conversation

@JPL11

@JPL11 JPL11 commented Jul 6, 2026 •

Copy link
Copy Markdown

Fixes #7345

Summary

insert_write_back_for_buffers_pass placed every write-back copy_ at the end of the graph, arbitrarily extending the lifetime of the value being written back and wasting space in the memory plan.

Each copy_(buffer, value) is now inserted at the earliest point that preserves the end-of-graph semantics. The copy must come after:

  • the value itself,
  • every reader of the buffer or any alias of it (they must observe the old contents) — this is the alias hazard that blocked the earlier attempt on the issue,
  • every mutation of the value or any alias of it (so we snapshot the final value),
  • all placeholders.

Aliases are found with a forward walk using schema alias_info; getitem, submodule calls, and schema-less targets are treated conservatively as aliasing, and mutation detection uses alias_info.is_write (conservative when unknown). This matters because reinplace_pass runs before this pass, so in-place ops can be present; views are still view_copy at this point since ReplaceViewCopyWithViewPass runs later.

If the value written back by one copy may alias the buffer mutated by another, the copies' relative order matters, so in that case all copies fall back to the old end-of-graph placement in their original order.

Test plan

Two new tests in exir/tests/test_passes.py:

  • test_mutable_buffers_write_back_is_inserted_early: the copy_ lands immediately after the value it writes back, before the rest of the graph.
  • test_mutable_buffers_write_back_after_old_value_reads: regression test for the alias/old-read hazard — a read of the buffer's old value traced after the new value is computed keeps the write-back late.

Existing test_mutable_buffers passes (its "After" graph comment updated for the new placement). Full exir/tests/test_passes.py, test_memory_planning.py, and emit/test/test_emit.py pass locally (one pre-existing failure on clean main, test_to_out_variant_none_output, unrelated).

cc @JacobSzwejbka @angelayi @nil-is-all @metascroy

Copilot AI lite review requested due to automatic review settings July 6, 2026 17:14
@pytorch-bot

pytorch-bot Bot commented Jul 6, 2026 •

Copy link
Copy Markdown

🔗 Helpful Links

🧪 See artifacts and rendered test results at hud.pytorch.org/pr/pytorch/executorch/20744

Note: Links to docs will display an error until the docs builds have been completed.

⚠️ 15 Awaiting Approval

As of commit 4087406 with merge base 40d17e1 (image):

AWAITING APPROVAL - The following workflows need approval before CI can run:

This comment was automatically generated by Dr. CI and updates every 15 minutes.

@meta-cla

meta-cla Bot commented Jul 6, 2026

Copy link
Copy Markdown

Hi @JPL11!

Thank you for your pull request and welcome to our community.

Action Required

In order to merge any pull request (code, docs, etc.), we require contributors to sign our Contributor License Agreement, and we don't seem to have one on file for you.

Process

In order for us to review and merge your suggested changes, please sign at https://code.facebook.com/cla. If you are contributing on behalf of someone else (eg your employer), the individual CLA may not be sufficient and your employer may need to sign the corporate CLA.

Once the CLA is signed, our tooling will perform checks and validations. Afterwards, the pull request will be tagged with CLA signed. The tagging process may take up to 1 hour after signing. Please give it that time before contacting us about it.

If you have received this in error or have any questions, please contact us at cla@meta.com. Thanks!

@linux-foundation-easycla

linux-foundation-easycla Bot commented Jul 6, 2026 •

Copy link
Copy Markdown

CLA Signed
The committers listed above are authorized under a signed CLA.

  • ✅ login: JPL11 / name: Jacky Li (1af26c7)

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates insert_write_back_for_buffers_pass so write-back aten.copy_ nodes for mutated buffers/inputs are inserted at the earliest safe point in the FX graph (instead of always at the end), reducing live ranges and improving downstream memory planning.

Changes:

  • Add schema-driven alias/mutation analysis utilities to determine the earliest safe insertion point for each write-back copy_.
  • Insert write-backs earlier when independent, while falling back to end-of-graph insertion when write-backs may interfere via aliasing.
  • Extend exir/tests/test_passes.py with new regression tests covering early insertion and “old value read” alias hazards, and update the existing test_mutable_buffers expected graph comment.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
exir/passes/insert_write_back_for_buffers_pass.py Implements earliest-safe write-back insertion with conservative alias/mutation analysis and an independence fallback.
exir/tests/test_passes.py Adds/updates tests to validate earlier insertion and alias-hazard ordering constraints.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread exir/passes/insert_write_back_for_buffers_pass.py Outdated
Comment thread exir/passes/insert_write_back_for_buffers_pass.py Outdated
@nil-is-all nil-is-all added the module: exir Issues related to Export IR and the code under exir/ label Jul 10, 2026
Copilot AI review requested due to automatic review settings July 10, 2026 18:51

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@JPL11

JPL11 commented Jul 10, 2026

Copy link
Copy Markdown
Author

Pushed the ufmt formatting fix for the lintrunner job. The lintrunner-mypy failures are in backends/cortex_m/quantizer/pattern_matcher.py and backends/arm/_passes/arm_pass_utils.py, which this PR does not touch, so those look like they need a fix on main.

@JPL11

JPL11 commented Jul 10, 2026

Copy link
Copy Markdown
Author

Triaged the six failures in the pull workflow run; none are from this diff:

  • unittest / linux, unittest-editable / linux, test-arm-backend-no-driver (test_pytest_ops_tosa): all die in environment setup building the tosa-tools serialization wheel (ERROR: Use build.verbose instead of cmake.verbose for scikit-build-core >= 0.10). Looks like a new scikit-build-core release broke that third party package today; the exir test suites never ran.
  • android / build-android and unittest-nxp-neutron (2h timeout): both also failed on main's last completed pull run (29037897153), so pre existing.
  • test-binary-size-linux-gcc: Fail 52168 > 48500. That measures the compiled C++ size_test binary; this PR only touches exir/*.py, so it cannot move that number. The threshold was last calibrated 2026-03-06 and something on main appears to have outgrown it.

For what it is worth, the write back tests and the full exir/tests/test_passes.py pass locally on this branch.

@nil-is-all

Copy link
Copy Markdown
Contributor

Thanks @JPL11, some CI failures are irrelevant. I'll trigger it again just-in-case. Could you sign the MetaCLA agreement if you haven't yet?

Copilot AI review requested due to automatic review settings July 11, 2026 23:58

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@JPL11

JPL11 commented Jul 11, 2026 •

Copy link
Copy Markdown
Author

Thanks @nil-is-all! CLA is signed already.

The re-run did surface one real lint hit in my file that I had missed (flake8 B007, an unused loop variable from an enumerate I no longer needed), fixed and pushed. lintrunner --skip MYPY is clean locally on both changed files now. The remaining red jobs should be the external ones from the triage above (tosa-tools wheel setup, android and nxp from main, the binary size threshold).

@JPL11 JPL11 closed this Jul 12, 2026
@JPL11 JPL11 reopened this Jul 12, 2026
@meta-cla

meta-cla Bot commented Jul 12, 2026

Copy link
Copy Markdown

Thank you for signing our Contributor License Agreement. We can now accept your code for this (and any) Meta Open Source project. Thanks!

@meta-cla meta-cla Bot added the CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. label Jul 12, 2026

@ErenAta16 ErenAta16 left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Read this because #7345 has been picked up and dropped three times and this is the
first branch that actually implements it with tests. The approach is right: doing
a conservative alias walk before choosing the insertion point is the part that
makes the optimisation safe, and _may_alias_input and _mutates_input both
default to True when the schema cannot tell you, which is the correct direction to
fail in. node_order being built from enumerate(gm.graph.nodes) means the graph
is already topologically sorted, so the single forward pass in _collect_aliases
is sound rather than lucky.

The two tests are the right two. Asserting node_order[copy] == node_order[copy.args[1]] + 1
pins the optimisation, and test_mutable_buffers_write_back_after_old_value_reads
pins the safety condition that makes it non-trivial. That is more care than this
issue has had from anyone before.

One regression, and it is a crash rather than a behaviour change.
_insert_copy computes

last_placeholder = [node for node in gm.graph.nodes if node.op == "placeholder"][-1]

unconditionally at line 151, before anything checks whether there is a write-back
to insert. A graph with no placeholders makes that an IndexError. Modules with
no inputs are unusual but legal and torch.export handles them, so this is
reachable:

class NoInput(torch.nn.Module):
    def forward(self):
        return torch.ones(3) * 2

ep = export(NoInput().eval(), args=())
insert_write_back_for_buffers_pass(ep)

Run against the installed 1.4.1 pass and then against this branch's version of the
same file, same input:

main          placeholder count 0   pass completes cleanly
this branch   placeholder count 0   IndexError: list index out of range

insert_write_back_for_buffers_pass calls _insert_copy unconditionally at line
307, so there is no earlier return to save it. The graph in question has nothing
to write back, so today the pass is a no-op on it and afterwards it would throw.

Neither of the new tests catches this because both modules take an x. The
cheapest fix is to make the lookup tolerant rather than to guard the call site,
something like

placeholders = [node for node in gm.graph.nodes if node.op == "placeholder"]
last_placeholder = placeholders[-1] if placeholders else None

and then treating a None last_placeholder as "no placeholder floor" in
_insertion_point, where latest would start from return_node instead. A third
test with an input-free module would pin it.

One thing I could not check, so treat it as untested rather than as approval:
I did not verify the memory-planning win the issue asks for. I could not construct
a BUFFER_MUTATION output spec quickly outside your test harness, since raw
export alone did not produce one for me and your tests go through to_edge. So
I have verified the safety of the insertion logic by reading and the regression by
running, and I have taken the optimisation itself on the strength of your first
test rather than measuring a memory plan.

Environment for the runs above: executorch 1.4.1, torch 2.14.0+cpu, Python
3.12.10, Windows 11.

Copilot AI review requested due to automatic review settings September 16, 2026 22:28

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

Unresolved critical and moderate alias-analysis issues remain, and the dependent-copy fallback lacks coverage.

Get a fresh assessment by requesting another Copilot review.

Review details

Suppressed comments (2)

exir/passes/insert_write_back_for_buffers_pass.py:41

  • _may_alias_input is independent of which input reaches this node, so any aliased return is treated as an alias of every input. For example, aten.expand_as(x, state) returns a view of x, not state; when state is the seed, later users of that view are incorrectly counted as state readers. This can push an otherwise safe write-back past unrelated work (and can also trigger the multi-copy end-of-graph fallback), defeating the pass's earliest-placement goal. Match the return alias set to the specific input alias set, while retaining the conservative fallback only when that relationship is unavailable.
    schema = getattr(node.target, "_schema", None)
    if schema is None:
        return True
    return any(ret.alias_info is not None for ret in schema.returns)

exir/passes/insert_write_back_for_buffers_pass.py:199

  • The new independent=False fallback is not covered by the tests: the existing two-copy case uses distinct write-back sources and destinations, so this safety branch is never exercised. Add a case where one write-back value may alias another destination (for example, one mutable buffer is copied from another) and assert both the preserved copy order and final outputs.
    independent = True
    if len(copies) > 1:
        mutated_aliases: Set[torch.fx.Node] = set()
        return_aliases: Set[torch.fx.Node] = set()
        for mutated_node, return_node in copies:
  • Files reviewed: 2/2 changed files
  • Comments generated: 1
  • Review effort level: Lite

Comment thread exir/passes/insert_write_back_for_buffers_pass.py Outdated
@JPL11

JPL11 commented Sep 16, 2026

Copy link
Copy Markdown
Author

Thank you for the comprehensive review.

As you recommended, I have fixed the problem in b6457f4. The process of lookup by placeholders has become tolerant, as the program finds placeholders[-1] or returns None in case placeholders is empty. In addition, I have added the last_placeholder parameter to the _insertion_point function, which allows us to treat None as the absence of the placeholder floor. Finally, I added the third test case that you requested, which involves an input-free module. First, I executed the code using the old implementation to generate IndexError and, after that, I confirmed that the new implementation works fine the same way in torch 2.14.0 / executorch 1.4.1 / Python 3.12, as seen in your reports.

In addition to this, the commit also deals with two Copilot feedbacks issued in July, which were indeed relevant issues: _may_alias_input now returns False for the output node (since there is no value generated, the function might trigger end-of-graph fallback by mistake), and _mutates_input also inspects the list/tuple arguments which assures that the foreach-style operation mutating the tensor contained in the list is detected, thus covering the one missing element of the contract that states “answer conservatively True.”

The portion that you were unable to review states that merely exporting raw data does not guarantee you will receive BUFFER_MUTATION output specification since the buffer has to be lifted and mutated. The simplest way of doing that is to call to_edge shortly after calling export with the parameters module and arguments, and the program will be exported. Please note that the memory-planning win itself can be proven by the assertion node_order[copy] == node_order[copy.args[1]] + 1 (which states that write-back occurs immediately after the value recorded), but I fully agree that measuring the full memory-usage plan would serve as more reliable proof and I would be happy to add it if you are interested.

Copilot AI review requested due to automatic review settings September 16, 2026 22:45

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔵 Needs a closer look

Alias-aware scheduling and fallback ordering require final human validation.

0 open findings

🧠 Review effort: Lite

Copilot AI lite review requested due to automatic review settings October 13, 2026 01:31
@JPL11
JPL11 force-pushed the early-write-back-copies branch from 290e226 to c834270 Compare October 13, 2026 01:31

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

No blocking issues were identified; the remaining feedback is a minor test-coverage nit.

0 open findings

🧠 Review effort: Lite

Copilot AI lite review requested due to automatic review settings October 13, 2026 02:02
@JPL11
JPL11 force-pushed the early-write-back-copies branch from c834270 to 57c0388 Compare October 13, 2026 02:02

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔵 Needs a closer look

Alias- and mutation-sensitive graph scheduling warrants final human review.

0 open findings

🧠 Review effort: Lite

Copilot AI lite review requested due to automatic review settings October 13, 2026 03:51
@JPL11
JPL11 force-pushed the early-write-back-copies branch from 57c0388 to 82a8901 Compare October 13, 2026 03:51

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔵 Needs a closer look

Add regression coverage for user-input mutation alias and read hazards before approval.

0 open findings

🧠 Review effort: Lite

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔵 Needs a closer look

Alias-sensitive graph transformations require final human review.

0 open findings

🧠 Review effort: Lite

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔵 Needs a closer look

A moderate issue affecting write-back placement remains unresolved, along with a missing fallback-ordering test.

0 open findings

🧠 Review effort: Lite

JPL11 added 13 commits October 12, 2026 22:34
The insert_write_back_for_buffers pass placed every write-back copy_ at
the end of the graph, arbitrarily extending the lifetime of the value
being written back and wasting space in the memory plan.

Now each copy_(buffer, value) is inserted at the earliest point that
preserves the end-of-graph semantics: after the value is computed, after
every reader of the buffer or any alias of it (they must observe the old
contents), and after any mutation of the value or any alias of it (so we
snapshot the final value). Aliases are found with a forward walk using
schema alias_info, treating getitem, submodule calls, and schema-less
targets conservatively. If the value written back by one copy may alias
the buffer mutated by another, all copies fall back to the old
end-of-graph placement in their original order.

Fixes pytorch#7345
…_inputs (C901); rename shadowing loop var (F402)
reinplace_pass marks an annotation-only rewrite with
_share_alloc_with_arg_idx and the memory planner then places that
output on the argument's storage. The alias index only consulted
schemas, so such an output never joined its argument's alias closure
and a reader of it could be ordered after the write-back copy_.

_storage_sharing_inputs reads the annotation, the same edge
ReplaceViewCopyWithViewPass follows in _alias_source. _aliasing_inputs
adds it to the schema-derived set, and _mutates_input treats the
shared argument as written, since the output lands in its storage.
The schema walk in _mutates_input moves to _schema_writes_input to
keep the function under the complexity limit.

Regression test: a maximum of the buffer carrying the annotation,
read after the buffer's new value is computed; the write-back must
follow that read.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔵 Needs a closer look

Alias-sensitive graph scheduling warrants final human review.

0 open findings

🧠 Review effort: Lite

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. community: contribution PRs coming from community (excluding hardware partners) module: exir Issues related to Export IR and the code under exir/ release notes: exir Changes to any dialects and passes on these dialects, such as memory planning

Projects

None yet

Development

Successfully merging this pull request may close these issues.

insert_write_back_for_buffers_pass should inject copy_ nodes at the earliest possible spot.

5 participants