[Bug 24908] Communication policy (blocking policy) API

[bugzilla-daemon at freedesktop.org]

http://bugs.freedesktop.org/show_bug.cgi?id=24908





--- Comment #1 from Simon McVittie <simon.mcvittie at collabora.co.uk>  2009-11-17 10:29:17 PST ---
The Privacy interface exists in telepathy-spec git but does not generate HTML
(in all.xml it's annotated as "Never implemented, vague"). Its API is:

interface Connection.Interface.Privacy
    requires Connection

    An interface to support getting and setting privacy modes to configure
    situations such as not being contactable by people who are not on your
    subscribe list. If this interface is not implemented, the default can be
    presumed to be allow-all (as defined in GetPrivacyModes).

    method GetPrivacyMode () -> s
        Return the current privacy mode, which must be one of the values
        returned by GetPrivacyModes.

        out s: (unnamed): A string representing the current privacy mode
        raises Disconnected, NetworkError

    method GetPrivacyModes () -> as
        Returns the privacy modes available on this connection. The following
        well-known names should be used where appropriate:

        allow-all
            any contact may initiate communication
        allow-specified
            only contacts on your 'allow' list may initiate communication
        allow-subscribed
            only contacts on your subscription list may initiate communication

        out as: (unnamed): An array of valid privacy modes for this connection

    signal PrivacyModeChanged (s: Mode)
        Emitted when the privacy mode is changed or the value has been
        initially received from the server.

        s: Mode: The current privacy mode

    method SetPrivacyMode (s: Mode)
        Request that the privacy mode be changed to the given value, which
        must be one of the values returned by GetPrivacyModes. Success is
        indicated by the method returning and the PrivacyModeChanged
        signal being emitted.

        in s: Mode: The desired privacy mode
        raises Disconnected, NetworkError, PermissionDenied, InvalidArgument


-- 
Configure bugmail: http://bugs.freedesktop.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.