Open Ethernet Networking (OpEN) API Guide and Reference Manual  3.11.1.2
Functions
This Code Implements The OpEN Telnet Management API [OPENAPI_MGMTTELNET]

Functions

open_error_t openapiAgentTelnetAdminModeGet (openapiClientHandle_t *client_handle, OPEN_CONTROL_t *pMode)
 Gets admin mode of telnet session. More...
 
open_error_t openapiAgentTelnetAdminModeSet (openapiClientHandle_t *client_handle, OPEN_CONTROL_t mode)
 Sets admin mode of telnet Session. More...
 
open_error_t openapiAgentTelnetCurrentNumSessionsGet (openapiClientHandle_t *client_handle, uint32_t *pSession)
 Gets current active number of telnet sessions. More...
 
open_error_t openapiAgentTelnetNewSessionsGet (openapiClientHandle_t *client_handle, OPEN_CONTROL_t *pState)
 Gets new telnet session acceptance state. More...
 
open_error_t openapiAgentTelnetNewSessionsSet (openapiClientHandle_t *client_handle, OPEN_CONTROL_t state)
 Sets new telnet sessions acceptance state. More...
 
open_error_t openapiAgentTelnetNumSessionsGet (openapiClientHandle_t *client_handle, uint32_t *pSession)
 Gets maximum number of telnet sessions. More...
 
open_error_t openapiAgentTelnetNumSessionsSet (openapiClientHandle_t *client_handle, uint32_t maxSession)
 Sets maximum number of telnet sessions. More...
 
open_error_t openapiAgentTelnetTimeoutGet (openapiClientHandle_t *client_handle, uint32_t *pTimeout)
 Gets telnet session timeout information. More...
 
open_error_t openapiAgentTelnetTimeoutSet (openapiClientHandle_t *client_handle, uint32_t timeout)
 Sets telnet session timeout (in minutes). More...
 
open_error_t openapiSwDevCtrlTelnetMgmtPortNumGet (openapiClientHandle_t *client_handle, uint32_t *pPort)
 Gets telnet access port number. More...
 
open_error_t openapiSwDevCtrlTelnetMgmtPortNumSet (openapiClientHandle_t *client_handle, uint32_t port, OPEN_BOOL_t flag)
 Sets the port-number for Telnet Access. More...
 

Detailed Description

Function Documentation

open_error_t openapiAgentTelnetAdminModeGet ( openapiClientHandle_t client_handle,
OPEN_CONTROL_t pMode 
)

Gets admin mode of telnet session.

Parameters
[in]client_handleclient handle from registration API
[out]pModeTelnet access Mode [Enable/Disable]
Return values
OPEN_E_NONEOn success.
OPEN_E_FAILOn failure.
OPEN_E_PARAMInvalid argument.
Note
This API fetches telnet Session access admin mode state

OpEN API Version: 1.25

Examples:
telnet_example.c.
open_error_t openapiAgentTelnetAdminModeSet ( openapiClientHandle_t client_handle,
OPEN_CONTROL_t  mode 
)

Sets admin mode of telnet Session.

Parameters
[in]client_handleclient handle from registration API
[in]modeTelnet Access Mode [Enable/Disable]
Return values
OPEN_E_NONEOn success.
OPEN_E_FAILOn failure.
OPEN_E_PARAMInvalid argument.
Note
This API sets telnet access mode to enable/disable
Calling this API will change the running configuration of the switch.

OpEN API Version: 1.25

Examples:
telnet_example.c.
open_error_t openapiAgentTelnetCurrentNumSessionsGet ( openapiClientHandle_t client_handle,
uint32_t *  pSession 
)

Gets current active number of telnet sessions.

Parameters
[in]client_handleclient handle from registration API
[out]pSessioncurrent active telnet sessions count
Return values
OPEN_E_NONEOn success.
OPEN_E_FAILOn failure.
OPEN_E_PARAMInvalid argument.
Note
This API fetches current active number of telnet sessions

OpEN API Version: 1.25

Examples:
telnet_example.c.
open_error_t openapiAgentTelnetNewSessionsGet ( openapiClientHandle_t client_handle,
OPEN_CONTROL_t pState 
)

Gets new telnet session acceptance state.

Parameters
[in]client_handleclient handle from registration API
[out]pStateTelnet access Mode [Enable/Disable]
Return values
OPEN_E_NONEOn success.
OPEN_E_FAILOn failure.
OPEN_E_PARAMInvalid argument.
Note
This API fetches new telnet Session acceptance state

OpEN API Version: 1.25

Examples:
telnet_example.c.
open_error_t openapiAgentTelnetNewSessionsSet ( openapiClientHandle_t client_handle,
OPEN_CONTROL_t  state 
)

Sets new telnet sessions acceptance state.

Parameters
[in]client_handleclient handle from registration API
[in]stateAcceptance state of new telnet sessions[Enable/Disable]
Return values
OPEN_E_NONEOn success.
OPEN_E_FAILOn failure.
OPEN_E_PARAMInvalid argument.
Note
This API sets new telnet acceptance state to enable/disable
Calling this API will change the running configuration of the switch.

OpEN API Version: 1.25

Examples:
telnet_example.c.
open_error_t openapiAgentTelnetNumSessionsGet ( openapiClientHandle_t client_handle,
uint32_t *  pSession 
)

Gets maximum number of telnet sessions.

Parameters
[in]client_handleclient handle from registration API
[out]pSessionmaximum allowable number of configured telnet sessions
Return values
OPEN_E_NONEOn success.
OPEN_E_FAILOn failure.
OPEN_E_PARAMInvalid argument.
Note
This API fetches maximum number of telnet sessions configured

OpEN API Version: 1.25

Examples:
telnet_example.c.
open_error_t openapiAgentTelnetNumSessionsSet ( openapiClientHandle_t client_handle,
uint32_t  maxSession 
)

Sets maximum number of telnet sessions.

Parameters
[in]client_handleclient handle from registration API
[in]maxSessionmaximum allowable number of telnet sessions
Return values
OPEN_E_NONEOn success.
OPEN_E_FAILOn failure.
OPEN_E_PARAMInvalid argument.
Note
This API sets maximum number of telnet sessions
Calling this API will change the running configuration of the switch.

OpEN API Version: 1.25

Examples:
telnet_example.c.
open_error_t openapiAgentTelnetTimeoutGet ( openapiClientHandle_t client_handle,
uint32_t *  pTimeout 
)

Gets telnet session timeout information.

Parameters
[in]client_handleclient handle from registration API
[out]pTimeoutTelnet session timeout
Return values
OPEN_E_NONEOn success.
OPEN_E_FAILOn failure.
OPEN_E_PARAMInvalid argument.
Note
This API fetches information of telnet session timeout

OpEN API Version: 1.25

Examples:
telnet_example.c.
open_error_t openapiAgentTelnetTimeoutSet ( openapiClientHandle_t client_handle,
uint32_t  timeout 
)

Sets telnet session timeout (in minutes).

Parameters
[in]client_handleclient handle from registration API
[in]timeouttelnet session timeout
Return values
OPEN_E_NONEOn success.
OPEN_E_FAILOn failure.
OPEN_E_PARAMInvalid argument.
Note
This API sets telnet session timeout
Calling this API will change the running configuration of the switch.

OpEN API Version: 1.25

Examples:
telnet_example.c.
open_error_t openapiSwDevCtrlTelnetMgmtPortNumGet ( openapiClientHandle_t client_handle,
uint32_t *  pPort 
)

Gets telnet access port number.

Parameters
[in]client_handleclient handle from registration API
[out]pPorttelnet access port number
Return values
OPEN_E_NONEOn success.
OPEN_E_FAILOn failure.
OPEN_E_PARAMInvalid argument.
Note
This API fetches telnet access port number

OpEN API Version: 1.25

Examples:
telnet_example.c.
open_error_t openapiSwDevCtrlTelnetMgmtPortNumSet ( openapiClientHandle_t client_handle,
uint32_t  port,
OPEN_BOOL_t  flag 
)

Sets the port-number for Telnet Access.

Parameters
[in]client_handleclient handle from registration API
[in]portTelnet Access port-number
[in]flagFlag indicates if the port number needs to be applied immediately
Return values
OPEN_E_EXISTSOperation failed due to port number already in use.
OPEN_E_NONEOn success.
OPEN_E_FAILOn failure.
OPEN_E_PARAMInvalid argument.
Note
This API sets port-number for Telnet Access
Calling this API will change the running configuration of the switch.

OpEN API Version: 1.25

Examples:
telnet_example.c.