service-node

Description

Interfaces Implemented

Notifiers

cell-change

Notifier that is triggered after the object's cell was changed.

object-delete

Notifier that is triggered just before Simics object is deleted.

queue-change

Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.

Commands for this class

• add-host – add host entry
• arp – inspect and manipulate ARP table
• delete-host – delete host entry
• dhcp-add-pool – add DHCP pool
• dhcp-leases – print DHCP leases
• disable-real-dns – disable real DNS
• disable-service – disable network service
• enable-ftp-alg – enable FTP ALG
• enable-real-dns – enable real DNS
• enable-service – enable network service
• get-ip-address-from-pool – pop an IP address from the DHCP pool
• info – print information about the object
• list-host-info – list host info database
• route – show the routing table
• set-tftp-directory – set TFTP directory
• status – print status of the object
• tcpip-info – show TCP/IP info

Attributes

eth_interfaces

Pseudo attribute; read-only access; type: [o*]
The Ethernet interface objects used by this service node.

recorder

Required attribute; read/write access; type: o
Recorder device for recording and playback of network traffic.

routing_table

Optional attribute; read/write access; type: [[ss|iso]*]
The routing table used by this service node. The four sub-entries for each routing table entry are network, netmask, gateway and service-node. The network and gateway are specified as IP addresses in dot notation, and the netmask is specified as an IP address or as a prefix length. The service-node is the node connected to the network where the gateway resides. For a route where the destination is reachable on the other service-node's connected network, the gateway should be set to 0.0.0.0. To create a default route, both the network and netmask should be set to 0.0.0.0.

services

Optional attribute; read/write access; type: D
The network services provided by the service-node, as a dictionary, and their enabled/disabled status.

next_tcp_port

Optional attribute; read/write access; type: i
Next new local TCP port.

udp_pcbs

Optional attribute; read/write access; type: [[o|ni|si|siiiiiiioi]*]
UDP PCBs. Do not attempt to setup connections yourself using this attribute, but use functionality in each separate UDP service to do so.

udp_pcbs_all

Pseudo attribute; read-only access; type: [[o|ni|si|siiiiiiioi]*]
UDP PCBs. This attribute is identical to udp_pcbs with the exception that it can only be read and that it also includes connections that will not be checkpointed.

tcp_ticks

Optional attribute; read/write access; type: i
TCP ticks.

tcp_timer

Optional attribute; read/write access; type: i
TCP timer.

tcp_iss

Optional attribute; read/write access; type: i
TCP initial sequence number.

tcp_timer_active

Pseudo attribute; write-only access; type: i
Unused, kept for checkpoint compatibility.

tcp_pcbs

Optional attribute; read/write access; type: [[o|ni|si|siiisioiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii[d*][d*][d*]]*]
TCP PCBs. Do not attempt to setup connections yourself using this attribute, but use functionality in each separate TCP service to do so.

tcp_pcbs_all

Pseudo attribute; read-only access; type: [[o|ni|si|siiisioiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii[d*][d*][d*]]*]
TCP PCBs. This attribute is identical to tcp_pcbs with the exception that it can only be read and that it also includes connections that will not be checkpointed.

napt_enable

Optional attribute; read/write access; type: i
When set to non-zero, the service node will provide network address port translation as specified by RFC 3022. The current implementation can only handle TCP NAPT.

hosts

Optional attribute; read/write access; type: [[s|n,s,s,s]*]
(mac, ip, host, domain) The host database used by the DHCP and DNS servers.

host_pools

Optional attribute; read/write access; type: [[i,s,s,s[[s|n,s,s,s]*]]*]
The host database used by the DHCP and DNS servers.

host_boot_filename

Optional attribute; read/write access; type: [[ss|n]*]
Extensions to the host database with the BOOTP/DHCP boot filename. Each entry in the list is a sub list with a client IP address and the boot filename. If no entry exists in the host database for a client boots using BOOTP or DHCP, then the value of the default_boot_filename attribute is used.

default_boot_filename

Optional attribute; read/write access; type: s|n
Default boot filename supplied in replies from the BOOTP/DHCP server if no client specific filename is configured in the host_boot_filename attribute.

host_dhcp_options

Optional attribute; read/write access; type: [[s[[id]*]]*]
Extensions to the host database with client specific DHCP option values that the DHCP server uses in replies. If no client specific option exists, then the value in the default_dhcp_options attribute, if set, is used. There are also a number of built-in DHCP options that the server always replies to. A built-in option can be disabled by specifying an empty value for the option in question. Each entry in the attribute list is a sub list with a client IP address followed by yet one list with two entries: the option number and a byte array with the reply. Vendor specific options can not be defined using this attribute.

default_dhcp_options

Optional attribute; read/write access; type: [[id]*]
Extension of the build-in set of DHCP options that the DHCP server uses in replies. These default options are used if no client specific options are set in the host_dhcp_options attribute.

dhcp_leases

Optional attribute; read/write access; type: [[ssdii]*]
The active leases used by the DHCP service. The sub-entries for each lease are ip-address, mac-address, client-id, lease-time, timestamp. The lease time is given in seconds since the lease was issued.

dhcp_max_lease_time

Optional attribute; read/write access; type: i|n
The maximum lease time handed out by the DHCP server. If the value is Nil, or 0xffffffff, infinite leases are allowed.

dhcp6_serverid

Optional attribute; read/write access; type: s|d
The DUID identifying the DHCPv6 server.

dhcp6_valid_prefixes

Optional attribute; read/write access; type: [[is]*]
The IPv6 prefixes that are valid on the local link. The sub-entries for each prefix are prefix-length, ip-address. ip-address must be an IPv6 address.

dhcp6_lifetimes

Optional attribute; read/write access; type: [ii]
Preferred and valid lifetimes for IPv6 addresses.

dhcp6_dns_servers

Optional attribute; read/write access; type: [s*]
List of IPv6 addresses to DNS recursive name servers.

dhcp6_domain_search_list

Optional attribute; read/write access; type: [s*]
List of domain names representing the domain search list.

dhcp6_nis_servers

Optional attribute; read/write access; type: [s*]
List of IPv6 addresses to NIS servers.

dhcp6_nis_domain_name

Optional attribute; read/write access; type: s
The NIS domain name.

dhcp6_nisp_servers

Optional attribute; read/write access; type: [s*]
List of IPv6 addresses to NIS+ servers.

dhcp6_nisp_domain_name

Optional attribute; read/write access; type: s
The NIS+ domain name.

dhcp6_allocated_addresses

Optional attribute; read/write access; type: [[sii]*]
The allocated addresses. The sub-entries for each allocated address are address, commit-flag, decline-flag. address must be an IPv6 address.

dhcp6_clients

Optional attribute; read/write access; type: [[d[[iii[[sii]*]]*][[i[[sii]*]]*]]*]
All known clients.

allow_real_dns

Optional attribute; read/write access; type: b
If TRUE, the service node's DNS server will forward queries for unknown hosts to a real DNS server.

async_real_dns

Optional attribute; read/write access; type: b
If TRUE, the service node will forward the real DNS lookup in asynchronous mode.

tftp_sessions

Optional attribute; read/write access; type: [[iissssi]*]
The active sessions in the TFTP service. The sub-entries for each session are server TID, client TID, read/write, server IP address, client IP address, file name, last read block.

tftp_root_directory

Optional attribute; read/write access; type: s|n
The directory in which files read or written over TFTP are located. If it is null, the Simics search path is used for reading files, and uploaded files are stored in the current directory.

bootparam_udp_port

Optional attribute; read/write access; type: i
The UDP port currently used for the Sun RPC Bootparam protocol replies. For checkpointing only.

rpc_bindings

Optional attribute; read/write access; type: [[iiii]*]
List of RPC bindings (program, version, protocol, port) that are used by port mapper or RPCBIND services within the service node.

Provided By