NAME

       ifup - network interface management commands

NAME

          ifup - bring a network interface up

          ifdown - take a network interface down

SYNOPSIS

          ifup [-h] [-a] [-v] [-d] [--allow CLASS] [--with-depends]
                 [-X EXCLUDEPATS] [-f] [-n] [-s] [--print-dependency {list,dot}] [IFACE [IFACE ...]]

          ifdown [-h] [-a] [-v] [-d] [--allow CLASS] [--with-depends]
                 [-X EXCLUDEPATS] [-f] [-n] [--print-dependency {list,dot}] [IFACE [IFACE ...]]

DESCRIPTION

          ifup  and  ifdown commands can be used to configure (or, respectively, deconfigure) network interfaces
          based on interface definitions in the config file ifupdown2.conf (defaults to /etc/network/interfaces/
          file).

          ifquery(8)   maybe  used  in  conjunction  with  ifup  and  ifdown  commands  to  query  and  validate
          applied/running configuration.

          ifup  always  works  on  the  current  interfaces(5)   file   defined   in   ifupdown2.conf   (default
          /etc/network/interfaces). ifdown works on the last applied interface configuration.

          ifup  on  an  already  ifup'ed  interface  will  re-apply  the configuration, skipping already applied
          configuration wherever possible. In many cases where config commands are idempotent, you will see that
          ifup/ifdown will reapply the config even if the interface already has that config.

          ifup and ifdown understands interface dependency order.

          For  logical  interfaces like vlans, bridges, bonds, ifup creates the interface and ifdown deletes the
          interface. Use --admin-state option if you only want to administratively bring the interface up/down.

          When ifup and ifdown are used with interfaces on command line, they must be have a  iface  section  in
          the interfaces(5) file.

OPTIONS

          positional arguments:

          IFACE  interface list separated by spaces. IFACE list and '-a' argument are mutually exclusive.

          optional arguments:

          -h, --help
                 show this help message and exit

          -a, --all
                 process all interfaces marked "auto"

          -v, --verbose
                 verbose

          -d, --debug
                 output debug info

          --allow CLASS
                 ignore non-"allow-CLASS" interfaces

          -w, --with-depends
                 run  with all dependent interfaces. This option is redundant when -a is specified. When '-a' is
                 specified, interfaces are always executed in dependency order.

          -X EXCLUDEPATS, --exclude EXCLUDEPATS
                 Exclude interfaces from the list of interfaces to operate on. Can be specified  multiple  times
                 If  the  excluded  interface  has  dependent interfaces, (e.g. a bridge or a bond with multiple
                 enslaved interfaces) then each dependent interface must be specified in order to be excluded.

          -i INTERFACESFILE, --interfaces INTERFACESFILE
                 Uses   interfaces   file   instead   of   default   defined    in    ifupdown2.conf    (default
                 /etc/network/interfaces).   Also  in ifupdown2.conf, users are not allowed to specify their own
                 interfaces file unless disable_cli_interfacesfile is set to 0 (default is 1).

          -t {native,json}, --interfaces-format {native,json}
                 interfaces file format

          -f, --force
                 force run all operations

          -n, --no-act
                 print out what would happen, but don't do it

          -p, --print-dependency {list,dot}
                 print iface dependency in list or dot format

          -m, --admin-state, --no-scripts
                 don't run any addon modules/scripts. Only bring the interface administratively up/down

          -u, --use-current-config
                 By default ifdown looks at the saved state for interfaces to bring  down.  This  option  allows
                 ifdown  to look at the current interfaces file. Useful when your state file is corrupted or you
                 want down to use the latest from the interfaces file

          -s, --syntax-check
                 Only run the interfaces file parser

EXAMPLES

          # bringing up all interfaces
              ifup -a

          # bringing up interface list
              ifup swp1 swp2

          # bringing up interface with its dependents
              ifup br0 --with-depends

          # bringing down all interfaces
              ifdown -a

          # bringing down a single interface
              ifdown swp1

          # excluding interfaces using -X option
              ifdown -X eth0 -a

              ifup -X eth0 -a

              ifdown -X eth0 -X lo -a

          # using verbose -v option to see what is going on
              ifup -v -a

          # using debug -d option to see more of what is going on
              ifup -d -a

          # ignore errors
              ifup -a -f

              ifdown -a -f

          # run ifdown and ifup on all interfaces using service command/init script
              service networking restart

          # run ifup on all interfaces using service command/init script
              service networking start

          # ifdown on all interfaces using service command/init script
              service networking stop

          # To run ifup/ifdown on only interfaces that changed see ifreload(8)

SEE ALSO

          ifquery(8), ifreload(8), interfaces(5), ifupdown-addons-interfaces(5)

AUTHOR

       Roopa Prabhu <roopa@cumulusnetworks.com>

COPYRIGHT

       Copyright 2014 Cumulus Networks, Inc.  All rights reserved.