From 99faf3ece1badc566e7e75e769ff374250196197 Mon Sep 17 00:00:00 2001 From: Ryan Harper Date: Wed, 29 Mar 2017 22:03:04 -0500 Subject: doc: document network configuration defaults policy and formats. Add documentation for cloud-init networking configuration formats, default behavior, policy and other specific details about how network config is consumed and utilized. --- doc/rtd/topics/network-config-format-eni.rst | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 doc/rtd/topics/network-config-format-eni.rst (limited to 'doc/rtd/topics/network-config-format-eni.rst') diff --git a/doc/rtd/topics/network-config-format-eni.rst b/doc/rtd/topics/network-config-format-eni.rst new file mode 100644 index 00000000..b0904952 --- /dev/null +++ b/doc/rtd/topics/network-config-format-eni.rst @@ -0,0 +1,20 @@ +.. _network_config_eni: + +Network Configuration ENI (Legacy) +---------------------------------- + +`Cloud-init`_ supports reading and writing network config in the ``ENI`` +format which is consumed by the ``ifupdown`` tool to parse and apply network +configuration. + +As an input format this is **legacy**. In cases where ENI format is available +and another format is also available, it will prefer to use the other format. +This can happen in either :ref:`datasource_nocloud` or +:ref:`datasource_openstack` datasources. + +Please reference existing `documentation`_ for the +``/etc/network/interfaces(5)`` format. + +.. _Cloud-init: https://launchpad.net/cloud-init +.. _documentation: http://manpages.ubuntu.com/manpages/trusty/en/man5/interfaces.5.html +.. vi: textwidth=78 -- cgit v1.2.3