mirror of
https://github.com/CumulusNetworks/ifupdown2.git
synced 2024-05-06 15:54:50 +00:00
Rostislav KandilarovandJulien Fortin
06dd888a28
On some kind-of-minimalistic Ubuntu 18.04.1 extra python package `python-setuptools` was needed in order to compile from source the final DEB. ``` dpkg-buildpackage: info: source version 1.2.1 dpkg-buildpackage: info: source changed by Julien Fortin <[email protected]> dpkg-source --before-build ifupdown2 dpkg-buildpackage: info: host architecture amd64 dpkg-checkbuilddeps: error: Unmet build dependencies: python-setuptools dpkg-buildpackage: warning: build dependencies/conflicts unsatisfied; aborting ```
163 lines
4.5 KiB
ReStructuredText
163 lines
4.5 KiB
ReStructuredText
=========
|
|
ifupdown2
|
|
=========
|
|
|
|
Linux Interface Network Manager
|
|
|
|
* Free software: GNU General Public License v2
|
|
|
|
============
|
|
Installation
|
|
============
|
|
|
|
As of today (early june 2018), the preferred method to install ifupdown2, is by
|
|
building the source code (as it will always install the most recent stable
|
|
release). See `Installing latest stable release from sources`_ chapter.
|
|
|
|
Installing latest stable release from sources
|
|
---------------------------------------------
|
|
|
|
The sources for ifupdown2 can be downloaded from the `Github repo`_.
|
|
|
|
You can either clone the public repository:
|
|
|
|
.. code-block:: console
|
|
|
|
$ git clone git://github.com/CumulusNetworks/ifupdown2
|
|
|
|
Or download the `tarball`_:
|
|
|
|
.. code-block:: console
|
|
|
|
$ curl -OL https://github.com/CumulusNetworks/ifupdown2/tarball/master
|
|
|
|
Once you have a copy of the source, you should build a deb-package and install it
|
|
|
|
.. code-block:: console
|
|
|
|
$ cd ifupdown2 && git checkout master-next && make deb
|
|
|
|
The generated deb should be in the root directory (``../ifupdown2_1.2.1_all.deb``)
|
|
|
|
.. code-block:: console
|
|
|
|
$ dpkg -i ../ifupdown2_1.2.1_all.deb
|
|
|
|
We don't recommend using ``setup.py install`` directly, as it's still missing systemd/init.d scripts.
|
|
This capability should be added in the near future.
|
|
|
|
You might need to manually download dependencies. Mandatory dependencies:
|
|
|
|
.. code-block:: console
|
|
|
|
$ apt-get install build-essential devscripts dh-systemd fakeroot python-all python-docutils iproute2 python-ipaddr python-argcomplete python-setuptools
|
|
|
|
Suggested dependencies:
|
|
|
|
.. code-block:: console
|
|
|
|
$ apt-get install ethtool bridge-utils python-gvgen python-mako
|
|
|
|
.. _Github repo: https://github.com/CumulusNetworks/ifupdown2
|
|
.. _tarball: https://github.com/CumulusNetworks/ifupdown2/tarball/master
|
|
|
|
|
|
============
|
|
Contributing
|
|
============
|
|
|
|
Contributions are welcome, and they are greatly appreciated! Every little bit
|
|
helps, and credit will always be given.
|
|
|
|
You can contribute in many ways:
|
|
|
|
Types of Contributions
|
|
----------------------
|
|
|
|
Report Bugs
|
|
~~~~~~~~~~~
|
|
|
|
Report bugs at https://github.com/CumulusNetworks/ifupdown2/issues.
|
|
|
|
If you are reporting a bug, please include:
|
|
|
|
* Your operating system name and version (``uname -a``).
|
|
* Any details about your setup that might be helpful in troubleshooting.
|
|
* Content of configuration files such as ``/etc/network/interfaces``
|
|
* Detailed steps to reproduce the bug.
|
|
* Debug output of the ifupdown2 command (see ``--debug`` option)
|
|
|
|
Write Documentation
|
|
~~~~~~~~~~~~~~~~~~~
|
|
|
|
ifupdown2 could always use more documentation, whether as part of the
|
|
official ifupdown2 docs, in docstrings, or even on the web in blog posts,
|
|
articles, and such.
|
|
|
|
Submit Feedback
|
|
~~~~~~~~~~~~~~~
|
|
|
|
The best way to send feedback is to file an issue at https://github.com/CumulusNetworks/ifupdown2/issues.
|
|
|
|
If you are proposing a feature:
|
|
|
|
* Explain in detail how it would work.
|
|
* Keep the scope as narrow as possible, to make it easier to implement.
|
|
|
|
=======
|
|
Credits
|
|
=======
|
|
|
|
Development Lead
|
|
----------------
|
|
|
|
* Roopa Prabhu <[email protected]>
|
|
* Julien Fortin <[email protected]>
|
|
|
|
Contributors
|
|
------------
|
|
|
|
* Nikhil Gajendrakumar <[email protected]>
|
|
* Maximilian Wilhelm <[email protected]>
|
|
* Sven Auhagen <[email protected]>
|
|
* skorpy <[email protected]>
|
|
* Sam Tannous <[email protected]>
|
|
* Wilson Kok <[email protected]>
|
|
* John Berezovik <[email protected]>
|
|
* Daniel Walton <[email protected]>
|
|
* Anuradha Karuppiah <[email protected]>
|
|
* Balakrishnan Raman <[email protected]>
|
|
* Scott Emery <[email protected]>
|
|
* Dave Olson <[email protected]>
|
|
* David Ahern <[email protected]>
|
|
* Jonathan Toppins <>
|
|
* Nolan Leake <[email protected]>
|
|
* Sergey Sudakovich <[email protected]>
|
|
* Andy Gospodarek <>
|
|
* Satish Ashok <[email protected]>
|
|
* Scott Laffer <[email protected]>
|
|
* Vidya Sagar Ravipati <[email protected]>
|
|
* Marek Grzybowski <[email protected]>
|
|
* Gaudenz Steinlin <[email protected]>
|
|
* Nigel Kukard <[email protected]>
|
|
* Jeffrey <[email protected]>
|
|
* kokel <[email protected]>
|
|
|
|
Why not you too? :)
|
|
|
|
|
|
=======
|
|
History
|
|
=======
|
|
|
|
See changelog here: https://github.com/CumulusNetworks/ifupdown2/blob/master/debian/changelog
|
|
|
|
|
|
Credits
|
|
-------
|
|
|
|
This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.
|
|
|
|
.. _Cookiecutter: https://github.com/audreyr/cookiecutter
|
|
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage
|