Bug 14566 - ifupdown: Document supported stanzas for interfaces file
Summary: ifupdown: Document supported stanzas for interfaces file
Status: NEW
Alias: None
Product: Busybox
Classification: Unclassified
Component: Networking (show other bugs)
Version: 1.33.x
Hardware: All Linux
: P5 normal
Target Milestone: ---
Assignee: unassigned
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2022-02-02 05:11 UTC by Michael Cassaniti
Modified: 2022-02-02 05:11 UTC (History)
1 user (show)

See Also:
Host:
Target:
Build:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
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.