comparison doc/libervia-cli/info.rst @ 3488:c80a0f864b5d

doc: updated doc following global renaming
author Goffi <goffi@goffi.org>
date Sun, 21 Mar 2021 18:23:58 +0100
parents doc/jp/info.rst@ae09989e9feb
children c4464d7ae97b
comparison
equal deleted inserted replaced
3487:75427f0a5445 3488:c80a0f864b5d
1
2 ==================================
3 info: retrieve various information
4 ==================================
5
6 ``info`` groups subcommands used to retrieve read-only informations.
7
8 disco
9 =====
10
11 Display discovery information (see `XEP-0030`_ for details). This can be used to check
12 which features you server or a service is offering, and which items are available (items
13 can be services like chat room, gateways, etc).
14
15 You only have to specify the jid of the entity to check, and optionally a node.
16
17 By default both infos and items are requested, but you can restrict what to request by
18 using ``-t {infos,items,both}, --type {infos,items,both}``
19
20 .. _XEP-0030: https://xmpp.org/extensions/xep-0030.html
21
22
23 example
24 -------
25
26 Request infos and items from a server::
27
28 $ li info disco example.org
29
30 version
31 =======
32
33 Request software version of an entity. You only need to specify the jid of the entity as
34 positional argument.
35
36 Depending of the software and its configuration, you have software version, software name,
37 and the operating system on which the software is running.
38
39 example
40 -------
41
42 Check version of a server::
43
44 $ li info version example.org
45
46 session
47 -------
48
49 Give information about the session of the given profile. You'll get the full jid currently
50 used on the server, and the time when the session was started (which may not be the same
51 time as when the connection with the XMPP server was started).
52
53 example
54 -------
55
56 Get session informations::
57
58 $ li info session
59
60 devices
61 -------
62
63 List known devices for an entity. You'll get resource name, and data such as presence
64 data, and identities (i.e. name and type of the client used).
65
66 If entity's bare jid is not specified, a list of your own devices is returned.
67
68 example
69 -------
70
71 List known devices of Louise::
72
73 $ li info devices louise@example.org
74
75 Check if we have other devices connected::
76
77 $ li info devices