istack.rta

INtime networking stack.

istack.rta -i  : interface list
           -b  : build date
           -d  : turn on driver debug output
           -l <0..7> : debug output level - default 7
           -L  : list current devices (INtime for Windows only)
           -LL : list all devices (INtime for Windows only)
           -v  : verbose
           -?  : help

Description

istack.rta implements the IPv4 and IPv6 networking protocols. It is normally loaded using the netload.rta utility.

Command Line Options

-i interface list <ven0 ie1g0 ie1g1 ... >

-b Display the build date of the installed istack.rta.

-d Enable driver debug output (for diagnostics)

-l

Set the istack syslog level.
Debug output level 0..7. Default is 3 (send LOG_ERR messages and above)

`LOG_EMERG`	0	System is unusable
`LOG_ALERT`	1	Action must be taken immediately
`LOG_CRIT`	2	Critical conditions
`LOG_ERR`	3	Error conditions
`LOG_WARNING`	4	Warning conditions
`LOG_NOTICE`	5	Normal but significant conditions
`LOG_INFO`	6	Informational
`LOG_DEBUG`	7	Debug-level messages

-L Show a list of Ethernet devices assigned to the current INtime node and recognized by the network stack. Displays device IDs, name and interface name. The stack recognizes the interface name. (only available on INtime for Windows)

-LL List all the devices currently supported by the network stack and its drivers. Displays each device ID and a short description. (only available on INtime for Windows)

-v verbose output

-? show help

Controlling logging output via the Advanced Settings

These settings may be used in place of the '-d' and '-v' command line options.

# Create an advanced section in the node configuration settings

[ISTACK]

DEBUG - enable debug output, a non-zero value

VERBOSE - increase verbosity, 1,2,3, ...

# Enable debug output from a driver, but not the stack. The driver name is entered

# in upper case without the unit number.

[IE1G]

DEBUG - enable debug output, a non-zero value.

Other Options

The following options can be set in %INTIMECFG%{NodeName}/etc/loader.cfg.

vm.kmem_size=n
Set the amount of memory allocated to the stack. This value should be increased which additional interfaces are added. Additional factor affecting the amount of memory required are the number of sockets in use and the size of the socket buffers. The default value is 0x80000 if not value is set. The value 0x180000 is probably more realistic.
kern.max_pri=n
Priorities are relative (less than or equal) to this, exclusive of interrupt threads.
kern.workers_stack=n
Stack size for worker threads.
kern.workers_max=n
Defines the maximum number of worker threads allocated at start up. The number of worker threads determines the number of simultaneously blocking operations. If there are too few worker threads, applications may block until a worker thread completes and is ready to service another request. In this case, increase the number of worker threads.
kern.workers_timeout=n
Since threads never time out, this parameter is ignored.
vm.cache_size=n
Cache this number of memory allocations (don't return to heap).
vm.cache_clip=n
Don't cache allocations above this size.
kern.ipc.maxsockets=n
Maximum number of sockets

Files

The following files are cached by istack:

/etc/ethers
/etc/eui64
/etc/hosts
/etc/loader.cfg
/etc/networks
/etc/nsswitch.cfg
/etc/services
/etc/resolv.cfg

The files are cached to speed access and to ensure they are accessible if Windows becomes unavailable. The network library uses the cached copy. If the files are modified while istack runs, istack must be restarted.

Requirements

Versions	Link to
INtime 4.0	netlib.lib