Bug 14566

Summary: ifupdown: Document supported stanzas for interfaces file
Product: Busybox Reporter: Michael Cassaniti <michael>
Component: NetworkingAssignee: unassigned
Status: NEW ---    
Severity: normal CC: busybox-cvs
Priority: P5    
Version: 1.33.x   
Target Milestone: ---   
Hardware: All   
OS: Linux   
Host: Target:
Build:

Description Michael Cassaniti 2022-02-02 05:11:03 UTC
Hi,
First, thank you so much for Busybox. It makes my life very easy I must say. I'm using Busybox 1.33.1 under Alpine Linux 3.14. The current configuration should be at this URL: https://git.alpinelinux.org/aports/tree/main/busybox/busyboxconfig?id=1aa6700d1e4ef810f2319506e48a8b5316d17abe

I've read the man page for interfaces from these URLs and they don't all agree on the supported stanzas:

  - https://salsa.debian.org/debian/ifupdown/-/raw/19052e2ecb0a908428813b5bc25d5bd0283c5a18/interfaces.5.pre
  - https://manpages.org/etc-network-interfaces/5
  - https://www.systutorials.com/docs/linux/man/5-interfaces/

I'm likely not the only one to encounter confusion about what stanzas Busybox does and does not support. I did read the source code and do my best to determine what is supported. This documentation would cover what is __natively__ supported since using additional scripts essentially allows extending the syntax.

I found the following directives so far are not supported and I assume I've missed some:

  - rename
  - inherits
  - allow- stanzas (e.g.: allow-hotplug)
  - no-auto-down
  - no-scripts
  - description
  - template
  - source-dir is supported but not source-directory

Please note I'm not requesting any of these stanzas be supported as part of this bug. It would personally be nice to have rename supported, but I can understand why others mentioned above are not included.