man.rst/ifreload.8.rst

   1 ========
   2 ifreload
   3 ========
   4
   5 --------------------------------------
   6 reload network interface configuration
   7 --------------------------------------
   8
   9 :Author: Roopa Prabhu <roopa@cumulusnetworks.com>
  10 :Date:   2014-02-05
  11 :Copyright: Copyright 2014 Cumulus Networks, Inc.  All rights reserved.
  12 :Version: 0.1
  13 :Manual section: 8
  14
  15 SYNOPSIS
  16 ========
  17     ifreload [-h] (-a|-c) [-v] [-d] [-f] [-n] [-s]
  18
  19 DESCRIPTION
  20 ===========
  21     reloads network **interfaces(5)** file **/etc/network/interfaces**
  22     or config file defined in ifupdown2.conf file.
  23
  24     Runs **ifdown** on interfaces that were removed from the file and
  25     subsequently runs **ifup** on all interfaces.
  26
  27     ifreload is non-disruptive. It will fix running config to match what
  28     is configured in the interfaces file without bringing the interface
  29     down. There are some cases where on linux an interface config cannot
  30     be applied unless the interface is brought down...eg: change of mac
  31     address and a few bond attributes. For such attribute changes, it may
  32     flap the interface only if the linux kernel requires it to.
  33
  34     When removing an interface (iface section) from the interfaces file
  35     please make sure all its references are removed as well. Similarly
  36     when renaming an interface, please make sure all references to the
  37     interface are changed to the new name. Renaming an interface
  38     in the interfaces file results in ifdown of the old and ifup
  39     of the interface with the new name.
  40
  41     If you do not wish to execute **down** on any interfaces, but only **up** on
  42     interfaces that were already **up**, please see the **--currently-up**
  43     option below.
  44
  45 OPTIONS
  46 =======
  47     -h, --help            show this help message and exit
  48
  49     -a, --all             process all interfaces marked "auto"
  50
  51     -v, --verbose         verbose
  52
  53     -d, --debug           output debug info
  54
  55     -f, --force           force run all operations
  56
  57     -c, --currently-up    only reload auto and other interfaces that are
  58                           currently up. This can be used as a non-disruptive
  59                           alternative to -a because it will not down any
  60                           interfaces
  61
  62     -X EXCLUDEPATS, --exclude EXCLUDEPATS
  63                           Exclude interfaces from the list of interfaces to
  64                           operate on. Can be specified multiple times
  65                           If the excluded interface has dependent interfaces,
  66                           (e.g. a bridge or a bond with multiple enslaved interfaces)
  67                           then each dependent interface must be specified in order
  68                           to be excluded.
  69
  70     -s, --syntax-check    Only run the interfaces file parser
  71
  72
  73 EXAMPLES
  74 ========
  75     # reload all auto interfaces in **interfaces(5)** file
  76
  77     **ifreload -a**
  78
  79     # reload all interfaces using service command
  80
  81     **service networking reload**
  82
  83     # reload all currently up interfaces without bringing any interfaces down
  84
  85     **service networking reload-currently-up**
  86
  87 SEE ALSO
  88 ========
  89     ifup(8),
  90     ifdown(8),
  91     ifquery(8),
  92     interfaces(5),
  93     ifupdown-addons-interfaces(5)