Network

From RSS Extensions

Jump to: navigation, search

Working on describing for a wireless network in XML...

(THIS IS A DRAFT) : feel free to join to the discusion in this page Talk:Network

See an example at http://wifisj.no-ip.org/nodes.xml

Every item should be one node (but is permitted to have more than one).

As namespace i could be used in any xml as well as in rss. (* atributes are mandatory)

Namespace: network

Elements: node, name, description, status, service, hardware, ant, nic, net, link

network:node (Parent: item) A string that identifies the node for reference proposals
- id* - an identificator of the node for reference proposals
- type - here name must be one string of the type of node: router|ap|...

<network:node id="1" />

network:name (Parent: channel, node, service, hardware, nic, link) A string for the name of the node (could also be a FQDN)

<network:name>Walden1</network:name>

network:description (Parent: hardware, service, nic, ant, link, net) A string for description proposes.

<network:description>Linksys<network:description>

status (Parent: hardware, service, nic, link) an snmp url to get the information usefull to configure mrtg's (maybe in snmp-xml)
- state - Must be one string of that: full|running|test|build|gather|waiting|interest|offline
- nicid - the id of the nic (see network:nic) (only use on service element for dhcp like services, that depends of nic)

<network:status state="full"/>

network:hardware (Parent: node) To describe a hardware of the node
- id - an identificator of the service for reference proposals
- type - here name must be one string of the type of hardware: pc|laptop|...
network:name
network:description
network:status

<network:hardware>
  <network:description>Linksys<network:description>
</network:hardware>

network:service (Parent: node) To describe the services of the node
- id - an identificator of the service for reference proposals
- type* - here name must be one string of the service, if the service are a protocol must be the name of the protocol in lowercase
network:name
network:description
network:status

<network:service id="0" type="dhcp"></network:service>
<network:service id="1" type="jabber"><network:description>All people inside</network:description></network:service>

network:net (Parent: nic, link) Network configuration specification
- ipaddr - an ipv4 or ipv6 address of the nic
- netmask - the netmask address of the nic
- macaddr - the mac address of the nic
- ssid - the essid or ssid of the nic if is a wireless network
- proto - the protocol of the nic normaly any 802.x
network:name - a FQDN of the ip if it has
network:description

<network:net ipaddr="192.168.0.1" macaddr="00:11:22:33:44:55" proto="802.11bg"ssid="wireless_essid"/>

network:nic (Parent: hardware) NIC's specification
- id - an identificator of the nic for reference proposals
- speed - the maxium speed of the nic link
- type - the type of the link and could be one of the strings (possible to expand): internet|p2p|ap|hub|...|undef
network:description
network:status
network:net

<network:nic speed="54Mbps" type="ap">
   <network:net id="0" ipaddr="192.168.0.1" macaddr="00:11:22:33:44:55" proto="802.11bg"ssid="wireless_essid"/>
   <network:link nodeid="4" speed="54Mbps" type="wireless">
     <network:status>snmp://10.0.0.1/link1</network:status>
   </network:link>
</network:nic>

network:ant (Parent: hardware) To describe antenas
- id* - an identificator of the antenna for reference proposals
- type - the type of the antenna: omni|dir|sec|...
- dir - the direction of the antenna, usefull for sectorial antennas. Must be a numbrer and are exressed in degrees and 0 are North.
network:description

<network:ant id="0" anttype="dir" antdir="15">Description</network:ant>
<network:nic id="0">
   <network:link nodeid="4" antid="0" speed="54Mbps" type="wireless"/>
</network:nic>

network:link (Parent: nic, item) To describe the links between nodes (or point to networks if type are "resource)
- nodeid - the id of the destination node (not usabe on parent item)
- url - url of the destination network rss (not if are in the same rss)
- antid - the id of the antenna that uses the link (see network:ant) (not usabe on parent item)
- speed - to show the speed of the link (not usabe on parent item)
- type - could be one of the strings (possible to expand): wireless|wired|vpn|... (must be "resource" on parent item)
network:name
network:description
network:status
network:net (to check if shoud be here also for vpn's)

<network:nic id="0">
   <network:link nodeid="4" speed="54Mbps" type="wireless"/>
   <network:link nodeid="10" url="http://wifisj.no-ip.org/nodes.xml" speed="2Mbps" type="vpn"/>
</network:nic>

Interpretation of RSS common elements: