Known upstream issues
“Not filed” means no matching issue existed in avocado-linux/* when this page was written. Update the status when one is filed or fixed, and remove the entry once a fixed release is out.
avocado-cli
Section titled “avocado-cli”| Issue | Symptom | Workaround | Status |
|---|---|---|---|
| Extension images built empty from a full sysroot | A 4 KB BSP image; on the device, the merge fails and no extension service starts | Clean the extension, rebuild, run scripts/check-avocado-build.sh before flashing. Details |
Open: #283 — later comment narrows it to an inline packages: map in the project’s own extension; a fetched/manifest-only BSP extension was retested and found to populate correctly. #280 is related but the reporter’s own follow-up says it’s no longer a correctness bug now that #272 is merged — a performance idea, not a defect. |
Removing or renaming an overlay file, or an enable_services entry, never reaches the image |
A deleted mask or a disabled service stays active | Clean the component after any removal. Details | Not filed |
Packages named with {{ avocado.kernel.version }} are never recorded in the lock |
The lock lists old packages, or none, for that extension | Don’t rely on the lock for those packages. Details | Not filed |
| Runtimes on one target share extension state | {{ avocado.runtime }} ignores -r; runtimes overwrite each other’s images; a plain install repoints the shared extension sysroots |
One target per runtime, always pass -r. Details, sysroots |
Not filed |
The offline systemctl used for presets ignores DefaultInstance= |
getty@getty.service fails in a loop at every boot |
Mask getty@.service in the rootfs overlay. Details |
Not filed |
modprobe: isn’t in the build hash, and loads after daemon-reload |
Changing only modprobe: ships the old list; units can’t rely on the module at reload |
Clean the extension after changing modprobe:; load modules from the unit that needs them. Details |
Not filed |
A git ref that isn’t a branch or tag builds the default branch |
A pinned commit, or a mistyped tag, silently builds the tip | Pin tags only. Details | Not filed |
avocado clean leaves .avocado/overlay-staging/ |
Templated secrets stay on disk after a clean | Delete .avocado/ by hand. Details |
Not filed |
Unknown keys and unresolved templates in avocado.yaml aren’t reported |
A typo such as board: does nothing, silently |
Validate with the JSON Schema. Details | Reported |
avocadoctl
Section titled “avocadoctl”| Issue | Symptom | Workaround | Status |
|---|---|---|---|
An on_merge program that can’t be started fails the whole merge |
[FAILED] Failed to start Avocado merge extensions, then no SSH, gadget or getty |
Wrap commands whose program might be missing in a script that checks first. Details | Not filed |
meta-avocado
Section titled “meta-avocado”| Issue | Symptom | Workaround | Status |
|---|---|---|---|
The merge isn’t ordered before systemd-modules-load, systemd-sysctl, systemd-networkd or systemd-resolved |
Extension modules-load.d, sysctl.d, .network and .dnssd files are ignored at boot |
Rootfs drop-ins, modprobe:, or systemctl reload hooks. Details |
Not filed |
The empty /etc/machine-id is never persisted |
Hostname, USB serial and DHCP client ID change every boot | Derive identity from hardware. Details | Reported |
carrier.env without CARRIER_LABEL stops provisioning silently |
Provisioning exits 1 right after Carrier-BSP overlay: … (N file(s)) |
Always set CARRIER_LABEL. Details |
Not filed |
| Orin OS updates carry only the rootfs | Kernel, kernel DTB, bootloader and UEFI defaults only change with a reflash | Get the DTB and flash settings right before shipping | Not filed |
| The Tegra device-tree overlay hook (#292) isn’t in any feed | avocado sdk install fails when an extension declares device_tree_overlays |
Rebuild the DTB yourself. Details | Not filed |
One module SKU per target, and a fixed nvpmodel.conf |
Another module needs hand-copied flash values; an 8GB NX gets the 16GB power table | One carrier extension per module. Details | Not filed |
Only the first carrier-bsp/ is used |
A project’s flash settings are dropped when a carrier ships its own | Merge into one directory. Details | Not filed |
kernel.cmdline/cmdline_extra and the project’s initramfs: are accepted but never reach the Jetson boot image, on deploy or provision |
/proc/cmdline is empty of anything you set; kernel-level hardening options can’t be applied |
None known; a KernelCommandLine UEFI variable seeded via BOOTCONTROL_OVERLAYS is an untested possibility. Details |
Not filed, but related: meta-avocado#391 (open) starts repacking the Orin boot.img cmdline with two avocado.root_partuuid values for rootfs discovery — not cmdline_extra or a general mechanism. meta-avocado#398 is hardware debugging from that same PR. |
| The Orin NX BSP extension lacks CAN, Wi-Fi/BT stack, camera and netfilter modules | can0 never appears on an NX |
Add the packages in a carrier extension. Details | Not filed |
| The RTC driver loads after the merge and steps the clock back | The clock jumps to 1970 a few seconds into boot | A real time source. Details | Not filed |
| Realtek Bluetooth firmware is in the BSP extension, which merges after the device probes | Direct firmware load for rtl8822cu_fw failed with error -2 |
Not yet known. Details | Not filed; needs a device check |
jetson-orin-nx builds split stone include paths on spaces |
The first bundle pass searches a path that doesn’t exist; the CLI’s own pass hides it | None needed today | Fix open: #397 |