blob: d98f5d57a1f89ccd056da2c8db2f24a2998955a3 [file] [log] [blame]
MG Mud User88f12472016-06-24 23:31:02 +02001SYNOPSIS
Zesstra7ea4a032019-11-26 20:11:40 +01002 object connect(void)
MG Mud User88f12472016-06-24 23:31:02 +02003
4DESCRIPTION
Zesstra7ea4a032019-11-26 20:11:40 +01005 Return a login object that the requested connection should be
6 bound to.
MG Mud User88f12472016-06-24 23:31:02 +02007
Zesstra7ea4a032019-11-26 20:11:40 +01008 Note that the connection is at this time bound to the master object,
9 and will be re-bound to the returned object.
10
11 The lfun logon() will be applied to the login object after
12 binding the connection to it. That lfun has to return != 0 to
13 indicate success.
14
15 If connect() initiates a secure connection without setting a callback,
16 and the connection is still handshaking at the time connect() returns,
17 the driver will delay the call to logon() until the handshake either
18 succeeds or fails.
19
20HISTORY
21 LDMud 3.2.13/3.3.713 streamlined the handling of secure connections
22 during logon.
MG Mud User88f12472016-06-24 23:31:02 +020023
24SEE ALSO
Zesstra7ea4a032019-11-26 20:11:40 +010025 logon(A), disconnect(M), interactive(E), exec(E),
26 net_connect(E), tls_init_connection(E)