Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

bugfix: Kill compile processes that generates too much output #2883

Open
wants to merge 4 commits into
base: master
Choose a base branch
from

Conversation

cmaglie
Copy link
Member

@cmaglie cmaglie commented Apr 10, 2025

Please check if the PR fulfills these requirements

See how to contribute

  • The PR has no duplicates (please search among the Pull Requests
    before creating one)
  • The PR follows
    our contributing guidelines
  • Tests for the changes have been added (for bug fixes / features)
  • Docs have been added / updated (for bug fixes / features)
  • UPGRADING.md has been updated with a migration guide (for breaking changes)
  • configuration.schema.json updated if new parameters are added.

What kind of change does this PR introduce?

Previously, compiling a sketch containing an include loop could generate a lot of output and crash the Arduino CLI with an out-of-memory error. This is due to the library-discovery process that buffers the stderr output of the compiler for analysis after the process exits.

To fix this problem, a limit to the compiler output has been set to 100KB of data.

What is the current behavior?

$ cat sketch.ino
#include <a.h>
$ cat a.h
#include <a.h>
#include <a.h>
#include <a.h>
$ arduino-cli compile -b arduino:avr:uno

The process never terminates, and it's killed for OOM later by the kernel.

What is the new behavior?

$ cat sketch.ino
#include <a.h>
$ cat a.h
#include <a.h>
#include <a.h>
#include <a.h>
$ arduino-cli compile -b arduino:avr:uno
[...a lot of output truncated...]
In file included from /home/cmaglie/sketch/a.h:1:0,
                 from /home/cmaglie/sketch/a.h:2,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:2,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/a.h:1,
                 from /home/cmaglie/sketch/sketch.ino:1:
/home/cmaglie/sketch/a.h:1:15: error: #include nested too deeply
/home/cmaglie/sketch/a.h:2:15: error: #include nested too deeply
Compiler error output has been truncated.

Used platform Version Path
arduino:avr   1.6.22  /home/cmaglie/.arduino15/packages/arduino/hardware/avr/1.6.22
Error during build: signal: killed
$

Does this PR introduce a breaking change, and is titled accordingly?

A legitimate sketch may produce a lot of warnings from a single file, going over 100KB. In that extreme case, the sketch could not be compiled anymore with Arduino CLI.

100KB looks like a reasonable limit. By the way, there are no specific stats available about this, so we have to deploy this fix, get feedback from the user, and be ready to increase this limit if needed.

Other information

@cmaglie cmaglie self-assigned this Apr 10, 2025
@cmaglie cmaglie added type: enhancement Proposed improvement topic: CLI Related to the command line interface labels Apr 10, 2025
@cmaglie cmaglie requested a review from a team April 10, 2025 16:08
Comment on lines +93 to +94
cancel()
fmt.Fprintln(stderr, i18n.Tr("Compiler error output has been truncated."))
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
cancel()
fmt.Fprintln(stderr, i18n.Tr("Compiler error output has been truncated."))
fmt.Fprintln(stderr, i18n.Tr("Compiler error output has been truncated."))
cancel()

Probably I'd swap just in case the context cancellation unblocks the WaitWithinContext and returns the stderr bytes, before we appended the error string.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
topic: CLI Related to the command line interface type: enhancement Proposed improvement
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants