pubsub/node/affiliations: nodes subscriptions management

subscriptions is a subcommand handling the subscription to a node.

Those commands can only be used by an owner of the node.

get

Retrieve subscriptions to a node.

If --public is used, only public subscriptions are retrieved (if target service supports XEP-0465 Public Pubsub Subscriptions). Public subscriptions are accessible to anybody, thus you can use this on a node even if you are not an owner of it (and thus would not normally be allowed to retrieve subscriptions).

example

Get subscription from some_node:

$ li pubsub node subscriptions get -n some_node

Retrieve public subscribers to the blog of Louise:

$ li pubsub node subscriptions get --public -s louise@example.org -n urn:xmpp:microblog:0

set

Set subscriptions to a node. Subscriptions are specified with -S JID [SUSBSCRIPTION] [JID [SUSBSCRIPTION] ...], --subscription JID [SUSBSCRIPTION] [JID [SUSBSCRIPTION] ...] where JID is the jid of the entity to change subscription state, and SUBSCRIPTION is a subscription state (on of subscribed, pending, none) as specified in XEP-0060 Subscription State. If SUBSCRIPTION is not specified, it default to subscribed.

example

Subscribe Louise with her new address at louise@example.org and remove her subscription from old louise@example.com:

$ li pubsub node subscriptions set -n some_node -S louise@example.org subscribed louise@example.com none