Mercurial > libervia-backend

comparison doc/libervia-cli/pubsub.rst @ 3951:4b8776eb6826

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
doc (blog, pubsub): documentation on new e2ee arguments for pubsub, and shared secrets handling: fix 380
author Goffi <goffi@goffi.org>
date Sat, 15 Oct 2022 20:38:33 +0200
parents 8b76caa89aa0
children 9f85369294f3
comparison
equal deleted inserted replaced
3950:8f87ff449a34 3951:4b8776eb6826
22 `XEP-0060 §7.1.5`_ for details. 22 `XEP-0060 §7.1.5`_ for details.
23 23
24 In the same way as for :ref:`libervia-cli_pubsub_node_create`, ``-F, --full-prefix`` can be used if 24 In the same way as for :ref:`libervia-cli_pubsub_node_create`, ``-F, --full-prefix`` can be used if
25 you need to specify the full option name. 25 you need to specify the full option name.
26 26
27 |e2e_arg|
28
27 .. _XEP-0060 §7.1.5: https://xmpp.org/extensions/xep-0060.html#publisher-publish-options 29 .. _XEP-0060 §7.1.5: https://xmpp.org/extensions/xep-0060.html#publisher-publish-options
28 30
29 example 31 example
30 ------- 32 -------
31 33
37 39
38 get 40 get
39 === 41 ===
40 42
41 Retrieve items from specified node. Default output is prettified and highlighted XML. 43 Retrieve items from specified node. Default output is prettified and highlighted XML.
44
45 If the node is end-to-end encrypted, items will be automatically and transparently
46 decrypted if the shared secrets are known. If you want to avoid this behaviour and get the
47 items undecrypted, you can use the ``--no-decrypt`` flag.
42 48
43 example 49 example
44 ------- 50 -------
45 51
46 Retrieve the last 5 notes from our custom notes node:: 52 Retrieve the last 5 notes from our custom notes node::
72 Edit the raw XML of an item payload using your local editor (the one set in ``$EDITOR``). 78 Edit the raw XML of an item payload using your local editor (the one set in ``$EDITOR``).
73 79
74 If you don't change anything or publish an empty blog post, the edition will be cancelled. 80 If you don't change anything or publish an empty blog post, the edition will be cancelled.
75 81
76 :ref:`draft_common` commands can be used. 82 :ref:`draft_common` commands can be used.
83
84 |e2e_arg|
77 85
78 example 86 example
79 ------- 87 -------
80 88
81 Edit the last note in our custom node:: 89 Edit the last note in our custom node::
448 =========== 456 ===========
449 457
450 Subcommands to add or remove data attached to pubsub items. Please check 458 Subcommands to add or remove data attached to pubsub items. Please check
451 :ref:`libervia-cli_pubsub_attachments`. 459 :ref:`libervia-cli_pubsub_attachments`.
452 460
461 secret
462 ======
463
464 Subcommands for pubsub node shared secrets management. Please check :ref:`libervia-cli_pubsub_secret`.
465
453 hook 466 hook
454 ==== 467 ====
455 468
456 Subcommands for hooks management. Please check :ref:`libervia-cli_pubsub_hook`. 469 Subcommands for hooks management. Please check :ref:`libervia-cli_pubsub_hook`.
457 470