===== ipsctl =====

-----
Nokia Knowledge-Base ID: 1132644 
-----

__**Description**__\\
This resolution covers the use of the ipsctl command. This can be used to view and set various kernel variables.\\
**Note:** This is not an end-user tool and any changes to these variables should be verified by Nokia Support. It is possible to negatively affect the operation of a Nokia IP Applications platform by making the wrong change.

__**Resolution**__\\
**Interactive Mode**: 
To use ipsctl in interactive mode to view settings use the ''ispctl -i'' command.

<code>
nokia[admin]# ipsctl -i
ipsctl Nov 19 05:40:36
 > hw
=> ifphys
 > interface
 > kern
 > net
 
explore:  j, k down,up   <, > left, right   h help   q quit
</code>

Example of the view of a ethernet port:
<code>
interface: eth-s1p1c0 
addrmax 0 
addrmin 0 
altmtu0 
 > family: inet 
 > flags<up,phys_avail,link_avail,broadcast> 
hdrmax0 
hdrmin0
=index 2 
label 0 
lencaps 
lname 
mtu1514 
name eth-s1p1c0 
phys eth-s1p1 
 > stats
</code>


__**Command Line Interface**__\\
You can also dump all current ispctl settings with the ''ipsctl -a'' command. Used with ''grep'' you can filter on specific settings.
Example:
<code>
nokia[admin]# ipsctl -a | grep eth-s1p1c0
//ifphys: eth-s1p1:log: eth-s1p1c0 = 2
interface: eth-s1p1c0:index = 2
interface: eth-s1p1c0:addrmin = 0
interface: eth-s1p1c0:addrmax = 0
interface: eth-s1p1c0:hdrmin = 0
interface: eth-s1p1c0:hdrmax = 0
interface: eth-s1p1c0:mtu = 1514
interface: eth-s1p1c0:altmtu = 0
interface: eth-s1p1c0:label = 0
</code>

__**Changing variables with ipsctl**__\\
**Note:** the changes will not keep on a reboot. To enable the change on a reboot the command would need to be added to the ''/var/etc/rc.local'' file\\
Note: Please contact Nokia support before you use one of these commands. In general these would only be used as a workaround to a problem.\\
Example: Here is a command to allow directed broadcasts. This is disabled by default.See Resolution 825 for more information on this specific example.
<code>
ipsctl -w net: ip: forward: allow_directed: bcast 1
</code>
__**Example of firewall related ipsctl variables and their meaning:**__
<code>
net: ip: fw:registrations=1/* means fwregistration is true 
 */net: ip: fw:de-registrations=0 /*fw registed. 
 */net: ip: fw:input_calls/* how many fw input packet.
 */net: ip: fw:output_calls /*# of output fw packet.
 </code>