From 428ac8930ef8cf312523a4d8b24eeda26729c4b3 Mon Sep 17 00:00:00 2001 From: Danielle Madeley Date: Mon, 14 Feb 2011 12:10:35 +1100 Subject: Add draft Conn.I.ContactBlocking (danni's version) to extensions --- .../Connection_Interface_Contact_Blocking.xml | 172 +++++++++++++++++++++ extensions/Makefile.am | 1 + extensions/misc.xml | 1 + 3 files changed, 174 insertions(+) create mode 100644 extensions/Connection_Interface_Contact_Blocking.xml (limited to 'extensions') diff --git a/extensions/Connection_Interface_Contact_Blocking.xml b/extensions/Connection_Interface_Contact_Blocking.xml new file mode 100644 index 00000000..543d43a5 --- /dev/null +++ b/extensions/Connection_Interface_Contact_Blocking.xml @@ -0,0 +1,172 @@ + + + Copyright © 2009-2010 Collabora Ltd. + Copyright © 2009 Nokia Corporation + +

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.

+ + + + + +

An interface for connections where contacts can be blocked from + communicating with this user and receiving this user's presence.

+ +

When this interface becomes stable, it will replace the ContactList channel with TargetHandleType + Handle_Type_List and TargetID 'deny'.

+ + + + +

Direct the server to block some contacts. The precise effect is + protocol-dependent, but SHOULD include ignoring all current and + subsequent communications from the given contacts, avoiding sending + presence to them in future, and if they were already receiving the + local user's presence, behaving as if the local user went + offline.

+ +

FIXME: do we need to allow this on protocols where it won't + persist, or where we can't edit the block lists?

+ + + + Some contacts to block. + + + + +

In addition to blocking, report these contacts as abusive to the + server administrators.

+ +

Clients can determine whether this capability is available by + checking the + ContactBlockingCapabilities + property. If the capability is not present and this argument is + true, the error NotCapable SHOULD + be raised.

+ + + Some protocol libraries, in their conformance requirements, + require the ability to report blocked contacts as abusive. + + + + + + + + + + + + + + +

Reverse the effects of a previous call to + BlockContacts.

+ + + + Some contacts to unblock. + + + + + + + + + + + +

List the contacts that are blocked.

+ +

Clients SHOULD allow a relatively long timeout for calls to this + method, since on some protocols contact blocking is part of the + contact list, which can take a significant time to retrieve.

+ + + + The list of blocked contacts. + + + + + + + + + + + +

Emitted when the list of blocked contacts is first retrieved + (before returning from any pending calls to + RequestBlockedContacts), and + whenever the list of blocked contacts subsequently changes.

+ + + + Contacts added to the result of + RequestBlockedContacts. + + + + Contacts removed from the result of + RequestBlockedContacts. + + + + + +

True if the contact would be in the result of + RequestBlockedContacts; + False or omitted if the contact is not blocked, or if it is + unknown whether the contact is blocked.

+ + + + + +

Additional capabilities for contact blocking (i.e. whether we can + report abusive contacts).

+ +

Note: there is no capability for supporting blocking itself, + the presence of this interface indicates that contact blocking is + supported.

+ + + + + + + This protocol is capable of reporting abusive contacts to the server + administrators. + + + + + + + diff --git a/extensions/Makefile.am b/extensions/Makefile.am index d0f10482..b3147f30 100644 --- a/extensions/Makefile.am +++ b/extensions/Makefile.am @@ -18,6 +18,7 @@ EXTRA_DIST = \ Authentication_TLS_Certificate.xml \ Channel_Interface_Credentials_Storage.xml \ Channel_Type_Server_TLS_Connection.xml \ + Connection_Interface_Contact_Blocking.xml \ $(NULL) noinst_LTLIBRARIES = libemp-extensions.la diff --git a/extensions/misc.xml b/extensions/misc.xml index b1f6e88e..9b153f11 100644 --- a/extensions/misc.xml +++ b/extensions/misc.xml @@ -10,5 +10,6 @@ + -- cgit v1.2.3