ncftool manpage
by Serge Hallyn
I added nothing of value here, just turned the 'ncftool help' output
into a ncftool.1 manpage.
thanks,
-serge
.TH NCFTOOL 1 "December 20, 2011"
.SH NAME
ncftool \- Network configuration tool
.SH SYNOPSIS
.B ncftool [options]
.SH DESCRIPTION
ncftool is a command line utility to configure networking.
.SH OPTIONS
.TP
.B list [\-\-macs] [\-\-all] [\-\-inactive]
List the currently configured toplevel network interfaces
.br
.BR [\-\-macs]
show MAC addresses
.br
.BR [\-\-all]
show all (up & down) interfaces
.br
.BR [\-\-inactive]
show only inactive (down) interfaces
.TP
.B dumpxml [\-\-mac] [\-\-live] <name>
Dump the XML description of an interface
.br
.BR [\-\-mac]
interpret the name as MAC address
.br
.BR [\-\-life]
include information about the live interface
.br
.BR <name>
the name of the interface
.TP
.B define <xmlfile>
Define - define an interface from an XML file
.br
.BR <xmlfile>
file containing the XML description of the interface
.TP
.B undefine <iface>
Remove the configuration of an interface
.br
.BR <iface>
the name of the interface
.TP
.B ifup <iface>
Bring up an interface
.br
.BR <iface>
the name of the interface
.TP
.B ifdown <iface>
Bring down an interface
.br
.BR <iface>
the name of the interface
.TP
.B change-begin
Mark the beginning of a set of revertible network config changes
.TP
.B change-commit
Commit (makes permanent) of a set of network config changes
.TP
.B change-rollback
Rollback (revert) a set of network config changes
.TP
.B help [<command>]
List all commands or print details about one command
.br
.BR <command>
If specified, list help about the listed command. Otherwise list all commands.
.TP
.B quit
Exit the program
.TP
.SH SEE ALSO
.BR interfaces (5)
.SH AUTHOR
Serge Hallyn <serge.hallyn(a)ubuntu.com>
11 years, 7 months
[PATCH 0/9] Ubuntu netcf patches
by Serge Hallyn
Hi guys,
following is the set of patches applied in the Ubuntu package. I was
sure I had sent these before, but they're not in the archive. I was
wondering why there had never been any discussion! Sorry about that.
thanks,
-serge
11 years, 11 months
Ubuntu patches for netcf
by Laine Stump
On 10/28/2011 09:53 AM, Serge E. Hallyn wrote:
> Quoting Daniel P. Berrange (berrange(a)redhat.com):
>> On Thu, Oct 27, 2011 at 11:04:52PM -0500, Serge E. Hallyn wrote:
>>> Quoting Serge E. Hallyn (serge.hallyn(a)canonical.com):
>>>> Ah, an email from the good folks over at libguestfs suggested always doing
>>>> an aug_save() after any aug_set(). Doing that fixed it for me. It seems
>>>> more problematic since aborting partway through will result in a bad
>>>> interfaces file, so I may have to add rollback after all, but right now I'm
>>>> just glad it's working :)
>>> And now I've figured out the root of the problem - me. I was forcing
>>> get_augeas to rerun aug_load() every time.
>> Cool, glad it know it now does in fact work for someone other than
>> myself :-)
>>
>>> A tree which works for me on debian and ubuntu is at:
>>>
>>> http://bazaar.launchpad.net/~serge-hallyn/+junk/netcf/files
>> Are you planning on submitting those patches to this list ? The libnl ones
>> will probably need to have some kind of conditional compilation, so we can
>> support both versions of libnl.
> Yes, absolutely. I was thinking about trying to clean them up first,
> but that probably means I'll never get to them so maybe I'll send them
> today.
Serge,
After getting some netcf-related libvirt bug reports identified as
coming from an ubuntu system, I realized that you must now have a
released netcf build for ubuntu, but it's based on an upstream netcf git
checkout rather than a release. Any chance you could post the patches
you made so that I can push them and make a new upstream release (I'll
probably bump it from 0.1.9 to 0.2.0 to celebrate a released working
port on a new platform :-)
Thanks!
Laine
12 years
change-* commands
by hiren panchasara
change-begin - mark the beginning of a set of revertible network config
changes
change-commit - commit the pending network config changes
change-rollback - rollback (revert) a set of network config changes
Hi folks,
Can someone please take some time out to explain how these commands are
supposed to work?
what is the input and output of these commands?
it seems we take snapshots of current configurations? can someone shed some
light, please?
Thanks in advance,
Hiren
12 years
dumpxml output format of resulting xml file
by hiren panchasara
Hi All,
I am looking inside /test/interface/ at ethernet-dhcp.xml and
ethernet-static.xml:
[1]ethernet-dhcp.xml
<interface type="ethernet" name="eth0">
<start mode="none"/>
<mac address="aa:bb:cc:dd:ee:ff"/>
<mtu size="1492"/>
<protocol family="ipv4">
<dhcp/><!-- peerdns="no"/>-->
</protocol>
</interface>
[2]ethernet-static.xml
<interface type="ethernet" name="eth1">
<start mode="onboot"/>
<protocol family="ipv4">
<ip address="192.168.0.5" prefix="24"/>
<route gateway="192.168.0.1"/>
</protocol>
</interface>
What I understand is, when "dumpxml em0" is called, if em0 is an ethernet
interface whose address has been provided by dhcp, the o/p *must* look like
[1] and if address is statically allocated, o/p *must* look like [2].
Please correct me if that is not accurate.
I want to understand rationale behind this format. How are these decided.
For example, why "mac address" and "mtu size" do not matter in [2]?
Thanks for all the work and help,
Hiren
12 years
oh hey ... just a note from over here in freebsd.org land
by Sean Bruno
Just a note of introduction as Hiren has been nice enough to keep the
questions to you guys coming when we are on the bus in the morning to
the offices.
He and I are thwacking on netcf at the moment in order to move on to
libvirt and then on to virtualization support on FreeBSD. So, you fine
folks are the first stop on this little journey that ends up with
libvirt support for BHyVe ... at some point.
Cheers.
Sean
12 years
define and undefine
by hiren panchasara
"define" takes an xmlfile as an argument, is that same as output of dumpxml?
And undefine would delete the interface from the configuration altogether.
Is my understanding correct?
Thanks a lot,
Hiren
12 years