erebion/libervia-backend
Watch
1
0
Fork
You've already forked libervia-backend
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

dpc (cli/info): update "disco" documentation to include new "external services":

Browse source 
fix 418
This commit is contained in:
Goffi 2023-04-07 15:18:39 +02:00
commit d50412c7f7
1 changed files with 14 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

21
doc/libervia-cli/info.rst
View file

@ -8,22 +8,29 @@ info: retrieve various information
disco
=====
Display discovery information (see `XEP-0030`_ for details). This can be used to check
which features you server or a service is offering, and which items are available (items
can be services like chat room, gateways, etc).
Display discovery information, including external discovery (see `XEP-0030`_ and
`XEP-0215`_ for details). This can be used to check which features you server or a service
is offering, which items are available (items can be services like chat room, gateways,
etc), ans which external services (i.e. non-XMPP services) are proposed.
You only have to specify the jid of the entity to check, and optionally a node.
You only have to specify the jid of the entity to check, and optionally a node. If a node
is specified, external services won't be retrieved even if ``all`` is used (as external
services don't have the notion of "node").
By default everything is requested (infos, items and external services), but you can
restrict what to request by using ``-t {infos,items,both,external,all}, --type
{infos,items,both,external,all}`` where ``both`` means infos and items, and ``all`` mean
than + external services.
By default both infos and items are requested, but you can restrict what to request by
using ``-t {infos,items,both}, --type {infos,items,both}``
.. _XEP-0030: https://xmpp.org/extensions/xep-0030.html
.. _XEP-0215: https://xmpp.org/extensions/xep-0215.html
example
-------
Request infos and items from a server::
Request infos, items and external services from a server::
$ li info disco example.org