Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Anchor10470561047056 TELNETs_Init() Anchor10470571047057Initialize the TELNET server. Anchor10435321043532

Files

...

...

telnet-s.h/telnet-s.c

...

Prototype

HTML Table
classCode_Listing
Table Row (tr)
Table Cell (td)
rowspan5
Anchor
10471461047146
Code Block
 CPU_BOOLEAN  TELNETs_Init
(CPU_BOOLEAN secure);
Table Row (tr)
Table Row (tr)
Table Row (tr)
Table Row (tr)

...

DEF_ENABLED
 (       NET_SOCK_ADDR_FAMILY   family,
                            const  TELNETs_SECURE_CFG    *p_secure_cfg)
Div
classWebWorks_Indent_1
Anchor
10487311048731

Arguments

family

IP family value for TELNET server.  

p_secure_cfg

Desired value for server secure mode :
       Secure Configuration Pointer Server operations will be secured.

...

classWebWorks_Indent_1

...

       DEF_NULL Server operations will

...

NOT be secured.

...

Returned Values

...

DEF_OK, TELNET server initialization successful;

...

...

DEF_FAIL, TELNET server initialization failed.

...

Required Configuration

...

  • Callbacks TELNETs_AuthUser() and TELNETs_CmdHandlerExt() shall be implemented by the user.
  • The network security manager MUST be available and enabled to accept a secure TELNET connection (i.e: in “net_cfg.h”, NET_SECURE_CFG_EN should be DEF_ENABLED AND NET_CFG_TRANSPORT_LAYER_SEL should be configured for TCP). See µC/TCPIP user manual for more information about the network security manager.

...

  • A network security module MUST be included in the project (i.e: µC/SSL) to use the network security manager functionalities.

...

...

Notes / Warnings

...

  • TELNETs_Init() must be called after product’s OS and network have been initialized.

...

...

  • Before accepting a secure TELNET connection, a public key certificate/private key pair MUST be installed.

...

classCode_Listing

...

rowspan8

...

Example Usage

See Sample application.