Docs
[prosody.git] / doc / session.txt
1 \r
2 Structure of a session:\r
3 \r
4 \r
5 session {\r
6         -- properties --\r
7         conn -- the tcp connection\r
8         notopen -- true if stream has not been initiated, removed after receiving <stream:steam>\r
9         type -- the connection type. Valid values include:\r
10                         -- "c2s_unauthed" - connection has not been authenticated yet\r
11                         -- "c2s" - from a local client to the server\r
12         username -- the node part of the client's jid (not defined before auth)\r
13         host -- the host part of the client's jid (not defined before stream initiation)\r
14         resource -- the resource part of the client's full jid (not defined before resource binding)\r
15         full_jid -- convenience for the above 3 as string in username@host/resource form (not defined before resource binding)\r
16         priority -- the resource priority, default: 0 (not defined before initial presence)\r
17         \r
18         -- methods --\r
19         send(x) -- converts x to a string, and writes it to the connection\r
20         disconnect(x) -- Disconnect the user and clean up the session, best call sessionmanager.destroy_session() instead of this in most cases\r
21 }\r