Mercurial > prosody-modules
view mod_roster_command/README.markdown @ 4362:116c88c28532
mod_http_admin_api: restructure group-related info in API
- Return the members of the group right in the get_group_by_id
call. This is an O(1) of extra work.
- Remove the groups attribute from get_user_by_name as that is
O(n) of work and rarely immediately needed.
The replacement for the group membership information in the user
is for now to use the group API and iterate; future work may fix
that.
author | Jonas Schäfer <jonas@wielicki.name> |
---|---|
date | Wed, 20 Jan 2021 15:30:29 +0100 |
parents | 8de50be756e5 |
children |
line wrap: on
line source
--- labels: - 'Stage-Beta' summary: Manage rosters through prosodyctl ... Introduction ------------ This module allows you to perform various actions on user rosters via prosodyctl. Details ------- After putting this module in your modules directory you can use it via prosodyctl like this: prosodyctl mod_roster_command COMMAND [OPTIONS...] **Note:** Do not add mod\_roster\_command to your Prosody config file. This is unnecessary because it will automatically be loaded by prosodyctl when you use it. ### Commands subscribe user@host contact@host Subscribes the user to the contact's presence. That is, the user will see when the contact is online (but the contact won't see the user). subscribe_both user@host contact@host The same as the 'subscribe' command, but performs the subscription in both directions, so that both the contact and user will always see each other online. unsubscribe user@host contact@host Removes a subscription to the contact's presence. unsubscribe_both user@host contact@host Same as unsubscribe, but also revokes a contact's subscription to the user's presence. rename user@host contact@host [name] [group] Sets or updates a name for a contact in the user's roster, and moves the contact to the given group, if specified. Compatibility ------------- ----- ------- 0.9 Works 0.8 Works ----- -------