API Reference | developer.brewmp.com API Reference | developer.brewmp.com

Developer

API Reference

INETMGR_SETOPT()

Brew Release
Brew MP 1.0.2
See Also
INETMGR_GetOpt() AEEUDPUrgent
Description
This function provides the ability to configure certain network options. It is similar in paradigm to ISOCKET_IOCtl(), but deals more with network-level items able to be configured, rather than socket-level items able to be configured.
Params
pINetMgr
[]:
Pointer to the INetMgr Interface to be used to set network options.
nOptName
[]:
Integer identifying which option to set
pOptVal
[]:
Filled with option-specific data
nOptSize
[]:
Size of pOptVal
Interface
  • INETMGR
Prototype
  •     int INETMGR_SetOpt
        (
        INetMgr *pINetMgr,
        int nOptName,
        void *pOptVal,
        int nOptSize
        );
    
Return
  • SUCCESS: if the option was set EPRIVLEVEL: if access to the option is prohibited by applet privilege EUNSUPPORTED: if nOptName is unknown EBADPARM: if nOptSize is set to a size that does not correspond to the correct option data
    other error, depending on the option
Side Effect
  • Depend on the option. All the above values modify only RAM values, and so they are lost when the device is reset.
Comments
Currently supported option ids are:
  • RLP options: these options are highly device dependent, and as such may not
  • be able to be configured, available, or well-behaved. They are protected by the
  • system privilege level
    • INET_OPT_DEF_RLP3
    • Default RLP settings, pOptVal must be an AEERLP3Cfg
    • INET_OPT_CUR_RLP3
    • Current RLP settings, pOptVal must be an AEERLP3Cfg
    • INET_OPT_PPP_AUTH
    • Set the system's configured PPP authentication credentials (protected by PL_SYSTEM).
    • pOptVal's type is char *, and the format of the inputted string must be: "userid\000passwd\000".
    DDTM option: this options is highly device dependent, and as such may not be able to be configured, available, or well-behaved. It is protected by the system privilege level.
    • INET_OPT_DDTM_PREF
    • Set the data dedicated transmission mode preference, pOptVal is a pointer to boolean
    • INET_OPT_SELECT_NET
    • Select the data network to use. If this option is not set, AEE_NETWORK_DEFAULT will be used
    • INET_OPT_DORMANCY_TIMEOUT
    • Set the packet data dormancy timeout (idle time until mobile dormancy is initiated) for a CDMA network.
    • The default value is set to 30 seconds.