Mercurial > libervia-backend
view doc/libervia-cli/pubsub_node_subscriptions.rst @ 3914:4cb38c8312a1
plugin XEP-0384, xml_tools: avoid `getItems` timeout + fix empty node crash + parsing:
- use `max_items` in `getItems` calls for bundles, as otherwise some pubsub service may
return full nodes, which may be huge is `max_items=1` is not set on the node, possibly
resulting in timeouts.
- the plugin was crashing when TWOMEMO devices list node has no items at all. This is not
the case anymore.
- a naive parsing method has been implemented in `xml_tools` to replace the
serialisation/deserialisation method. This should be more efficient and will avoid
annoying `ns0:` prefixes in XML logs.
| author | Goffi <goffi@goffi.org> |
|---|---|
| date | Sat, 24 Sep 2022 16:37:46 +0200 |
| parents | e597dbfbc4c6 |
| children |
line wrap: on
line source
.. _libervia-cli_pubsub_node_subscriptions: ======================================================== 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). .. _XEP-0465 Public Pubsub Subscriptions: https://xmpp.org/extensions/inbox/pubsub-public-subscriptions.html 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``. .. _XEP-0060 Subscription State: https://xmpp.org/extensions/xep-0060.html#substates 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