(Linux only) Add new subroutine XMPP.SBR, which allows sending of instant messages using the XMPP protocol (Extensible Message and Presence Protocol, aka Jabber) to third party instant messaging systems implementing that protocol. Compatible examples include the OpenFire messaging server and Pidgin client.
xcall XMPP, op, fromid, pw, server, port, toid, msg, msgid, flags
Parameters
op (num) [in]
Operation code:
|
Value |
Meaning |
|
1 |
connect, send message, disconnect |
status (signed num) [out]
Return code:
|
Value |
Meaning |
|
0 |
success |
|
-1 |
failed to initialize the xmpp library |
|
-2 |
unable to open xmpp.log |
|
-3 |
failed to initialize connection structure |
|
-4 |
failed to set server connection options |
|
-5 |
failed to connect (authentication? unreachable?) |
|
-6 |
failed to disconnect |
fromid (str) [in]
JID (Jabber ID) of sender, using syntax name@domain. Must be recognized by server for authentication.
pw (str) [in]
Authentication password for sender. Currently plain text. Encryption options to be added later.
server (str) [in]
Hostname or IP address of messaging server
port (num) [in]
Port to connect to server on (0 = default: 5222)
toid (str) [in]
JID of the receipient (individual or group), e.g. name@domain
msg (str) [in]
Text of message. There is no inherent limit to the length; dynamic strings (S,0) supported.
msgid (str) [in]
Short string to identify message, preferably unique. Mainly of use for tracking messages within the server.
flags (num) [in]
option flags (zero or more of the following)
|
Value |
|
Meaning |
|
AXMPPF_LOG |
&h0001 |
output traces to ashmpp.log |
|
AXMPPF_TRUST_TLS |
&h0002 |
trust all TLS certs |
|
AXMPPF_DISABLE_TLS |
&h0004 |
disable TLS; use insecure connect |
|
AXMPPF_DEBUG |
&h0008 |
low level tracing to xmpp.log |