man-pages/man8/netplan-apply.8.html
2021-03-31 01:06:50 +01:00

114 lines
3.2 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of netplan-apply</TITLE>
</HEAD><BODY>
<H1>netplan-apply</H1>
Section: (8)<BR>Updated: <BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
<P>
netplan-apply - apply configuration from netplan YAML files to a
running system
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<P>
netplan [-debug] apply -h | -help
<P>
netplan [-debug] apply
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<P>
netplan apply applies the current netplan configuration to a
running system.
<P>
The process works as follows:
<DL COMPACT>
<DT id="1">1.<DD>
The backend configuration is generated from netplan YAML files.
<DT id="2">2.<DD>
The appropriate backends (<A HREF="/cgi-bin/man/man2html?8+systemd-networkd">systemd-networkd</A>(8) or
<A HREF="/cgi-bin/man/man2html?8+NetworkManager">NetworkManager</A>(8)) are invoked to bring up configured
interfaces.
<DT id="3">3.<DD>
netplan apply iterates through interfaces that are still down,
unbinding them from their drivers, and rebinding them.
This gives <A HREF="/cgi-bin/man/man2html?7+udev">udev</A>(7) renaming rules the opportunity to run.
<DT id="4">4.<DD>
If any devices have been rebound, the appropriate backends are
re-invoked in case more matches can be done.
</DL>
<P>
For information about the generation step, see
<A HREF="/cgi-bin/man/man2html?8+netplan-generate">netplan-generate</A>(8).
For details of the configuration file format, see <A HREF="/cgi-bin/man/man2html?5+netplan">netplan</A>(5).
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT id="5"><B>-h, -help</B>
<DD>
Print basic help.
<DT id="6"><B>-debug</B>
<DD>
Print debugging output during the process.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>KNOWN ISSUES</H2>
<P>
netplan apply will not remove virtual devices such as bridges
and bonds that have been created, even if they are no longer described
in the netplan configuration.
<P>
This can be resolved by manually removing the virtual device (for
example ip link delete dev bond0) and then running
netplan apply, or by rebooting.
<A NAME="lbAG">&nbsp;</A>
<H2>SEE ALSO</H2>
<P>
<A HREF="/cgi-bin/man/man2html?5+netplan">netplan</A>(5), <A HREF="/cgi-bin/man/man2html?8+netplan-generate">netplan-generate</A>(8),
<A HREF="/cgi-bin/man/man2html?8+netplan-try">netplan-try</A>(8), <A HREF="/cgi-bin/man/man2html?7+udev">udev</A>(7),
<A HREF="/cgi-bin/man/man2html?8+systemd-networkd.service">systemd-networkd.service</A>(8), <A HREF="/cgi-bin/man/man2html?8+NetworkManager">NetworkManager</A>(8)
<A NAME="lbAH">&nbsp;</A>
<H2>AUTHORS</H2>
Daniel Axtens (&lt;<A HREF="mailto:daniel.axtens@canonical.com">daniel.axtens@canonical.com</A>&gt;).
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="7"><A HREF="#lbAB">NAME</A><DD>
<DT id="8"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="9"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="10"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="11"><A HREF="#lbAF">KNOWN ISSUES</A><DD>
<DT id="12"><A HREF="#lbAG">SEE ALSO</A><DD>
<DT id="13"><A HREF="#lbAH">AUTHORS</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:06:14 GMT, March 31, 2021
</BODY>
</HTML>