This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
This interface extends the core Account interface to provide a way for applications to request minimum presence on the account.
Some applications, for example mail notifiers or address book synchronisation, can make use of account's connection even while the user is nominally offline.
Each client's unique name may set a minimum desired presence on the
account. The combined presence is the most available presence
of the minimum presences set and of
Set a minimum presence needed by the client for this account. Setting (Offline, "offline", "") removes the minimum presence requirement for the client's unique name.
A map of active minimum presence requests.
Client unique name.
Requested minimum presence.
Some applications may want to monitor the currently active minimum presences required. An example is an tool allowing the user to inspect applications maintaining open connections and close those applications.