sctpctrl Subroutine

Purpose

Controls and configures SCTP.

Syntax

sctpctrl {load|unload|set} 
sctpctrl stats [reset] [interval] 

sctpctrl set {name=value|default [name]} 

sctpctrl get [name]

Description

The sctpctrl subroutine controls and configures the SCTP kernel extension. This subroutine can be used to load and unload the SCTP kernel extension. It can also be used to dump SCTP data, and set and retrieve various SCTP tunables. In addition, the sctpctrl subroutine can be used to read and reset the SCTP specific network statistics.

Parameters

Item Description
load Loads the SCTP kernel extension if not loaded.
unload Unloads the SCTP kernel extension if loaded.
stats [reset] [interval] Displays SCTP statistics. The optional reset command will clear (0) the statistics. If the interval parameter (in seconds) is added, the program does not exit; instead, it outputs the statistics every interval seconds.
set {name=value|default [name]} Sets the SCTP tunable to a value. If default is specified, all the tunables are set to their default values. If optional [name] is specified followed by default, the tunable described by name is set to its default value.
get [name] Gets the value of the tunable described by its optional name parameter. If the name parameter is not specified, get gets the values of all the tunables.

Examples

  1. To load the sctp kernel extension, enter:
    sctpctrl load
  2. To unload the sctp kernel extension, enter:
    sctpctrl unload
  3. To reset the SCTP statistics, enter:
    sctpctrl stats reset
    This command will zero-out all the SCTP statistics.
  4. To get the values of the SCTP tunable, enter:
    sctpctrl get

    This will list all the SCTP tunables and their values. Here is a sample output.

             sctp_assoc_maxerr = 10
             sctp_cookie_life = 60
             sctp_delack_timer = 4
             sctp_dontdelayack = 1
             sctp_ecn = 1
             sctp_ephemeral_high = 65535
             sctp_ephemeral_low = 32768
             sctp_instreams = 2048
             sctp_maxburst = 8
             sctp_outstreams = 10
             sctp_path_maxerr = 5
             sctp_pmtu_discover = 1
             sctp_rttmax = 60
             sctp_rttmin = 1
             sctp_recvspace = 65536
             sctp_sendspace = 65536
             sctp_send_fewsacks = 0
  5. To set sctp_path_maxerr to a value of 6, enter:
    sctpctrl set sctp_path_maxerr=6

Files

Item Description
/usr/sbin/sctpctrl Contains the sctpctrl command.
/usr/lib/drivers/sctp Contains the SCTP kernel extension.