Mercurial > libervia-backend
diff doc/jp/account.rst @ 3041:72583524cfd3
doc (jp): jp commands are now fully documented:
rel 232
author | Goffi <goffi@goffi.org> |
---|---|
date | Tue, 01 Oct 2019 22:49:06 +0200 |
parents | |
children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/jp/account.rst Tue Oct 01 22:49:06 2019 +0200 @@ -0,0 +1,75 @@ +================================ +account: XMPP account management +================================ + +``account`` command help you to create or manage the XMPP account of a server, using +In-Band Registration (`XEP-0077`_). + +.. _XEP-0077: https://xmpp.org/extensions/xep-0077.html + +create +====== + +Create a XMPP account. You have to specify your jid and password as positional arguments. +By default the registration is done on ``localhost`` with default XMPP Client 2 Server +port (i.e. 5222), but you can specify other host/port using ``-H HOST, --host HOST`` and +``-P PORT, --port PORT``. You may also specify an e-mail address using ``-e EMAIL, --email +EMAIL`` (use of this data depend of the server implementation). + +By default, no SàT profile is created and associated to this new XMPP account, but you can +use ``-p PROFILE, --profile PROFILE`` if you are willing to have one. + +example +------- + +Create account for the new user Nestor at ``nestor@example.org`` and associate it with the +SàT profile ``nestor``:: + + $ jp account create nestor@example.org some_password -p nestor + + +modify +====== + +Modify an existing XMPP account password. This will modify the XMPP account linked to the +given profile. + +.. note:: + + Only the XMPP password on the server is changed, not the one registered in the + parameter of SàT. You may have to update the parameter of your profile if the new + password doesn't correspond to your parameters one (you can do that with jp param set + or with most SàT frontends in parameters). + +example +------- + +Change the XMPP password of the XMPP account of the default profile:: + + $ jp account modify new_password + + +delete +====== + +Delete the XMPP account linked to the given profile from the XMPP server. Before using +this command, please be sure to understand well that **THIS WILL REMOVE THE WHOLE XMPP +ACCOUNT AND DATA FROM THE XMPP SERVER**. + +By default a confirmation is requested, you can do this without confirmation by using +``-f, --force``, however this is **NOT RECOMMENDED**, be sure to understand what you're +doing if you use this option (and be sure to spell correctly the profile, if you forget +the ``-p PROFILE, --profile`` argument for instance, this would delete entirely the +default profile). + +.. note:: + + Be extra careful with this command, as it will remove the whole account from the + server, and the associated data. + +example +------- + +Delete the XMPP account of Pierre, which is not on the local server anymore:: + + $ jp account delete -p pierre