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, 8 months
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, 1 month
Adding netcf support to FreeBSD
by hiren panchasara
Hi Folks,
I am trying to make netcf work with FreeBSD.
I am looking for more documentation on xml part of it. (I think augeas is
used for xml/xslt?)
I can "list" the interfaces but "dumpxml" does not work as I need to
prepare xml/xsl scaffolding.
Any pointers would be appreciated.
Thanks,
Hiren
12 years, 2 months