Commit 9d57350
committed
docs(extensions/netboot): document GNU tar requirement on the deploy target
The deploy hook untars the rootfs archive with --xattrs/--acls/--selinux,
which are GNU-tar extensions. Busybox tar (Alpine, OpenWRT) silently
drops xattrs on extract — file capabilities like security.capability on
ping/mtr are lost and they fail at runtime, regardless of the host
filesystem's xattr support. Capability-probe with fallback was
considered and rejected: there is no Busybox-tar code path that
preserves xattrs, so the only honest fallback would be silently broken
caps. Document the requirement instead.
Reported by coderabbitai (#9656 review, line 437).
Assisted-by: Claude:claude-opus-4.71 parent fee527a commit 9d57350
1 file changed
Lines changed: 9 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
320 | 320 | | |
321 | 321 | | |
322 | 322 | | |
| 323 | + | |
| 324 | + | |
| 325 | + | |
| 326 | + | |
| 327 | + | |
| 328 | + | |
| 329 | + | |
| 330 | + | |
| 331 | + | |
323 | 332 | | |
324 | 333 | | |
325 | 334 | | |
| |||
0 commit comments