tfTeldUserStartSsl

Table of Contents >> Application Reference >> Telnet Daemon

#include <trsocket.h>

int tfTeldUserStartSsl	(
	ttUserTeldHandle teldHandle,
	int sessionId
	);

Function Description

This function enables the Telnet over SSL feature for the specified connection (if you have purchased the Treck SSL server option). You must obtain a SSL session id (see the Treck SSL Programmer's Reference) by calling tfSslNewSession(). This function associates the SSL session id with teldHandle, and immediately begins server-side SSL handshaking. See Using SSL with the Treck TELNET Server for a full discussion and example code.

To enable the Telnet over SSL code, uncomment the following compile time macro in your trsystem.h module:

#define TM_USE_SSL_SERVER

Note:

This function begins an explicit SSL session on a connection sometime after the initial Telnet protocol exchange. This is distinctly different than the implicit SSL session that tfTeldUserSetSsl() establishes for the whole Telnet server.

Parameters

• teldHandle

  The connection handle received by your callback function tfNgTeldOpened() or tfTeldOpened().

• sessionId

  SSL session id returned by tfSslNewSession().

Returns

• TM_ENOERROR

  Success

• TM_EPERM

  Not initialized; call tfTeldUserInit() first.

• TM_EINVAL

  Invalid parameter.

• . . .

  (See setsockopt() for additional error codes).

Table of Contents >> Application Reference >> Telnet Daemon