16.2 Roster structure

Roster entries are contained in the list *jabber-roster*.

A roster entry is a symbol. Its name is the JID, and it is interned in jabber-jid-obarray. A roster entry can have the following properties:

xml

The XML tag received from the server on roster update

name

The name of the roster item (just like the XML attribute)

subscription

The subscription state (also copied)

ask

The ask state (copied)

groups

A list of strings (possibly empty) containing all the groups the contact is in

connected

Boolean, true if any resource is connected

show

Presence show status for highest-priority connected resource

status

Presence status message for highest-priority connected resource

resources

Alist. Keys are strings (resource names), values are plists with properties connected, show, status and priority.

Incoming presence information is inserted in resources, and the information from the resource with the highest priority is inserted in show and status by the function jabber-prioritize-resources.