Mercurial > prosody-modules
annotate mod_roster_command/README.md @ 6352:525655adfd3e
mod_report_affiliations: Fix traceback a non-user is sending a presence
For now we won’t touch their presence instead of emiting this traceback:
error Traceback[s2s]: /usr/lib/prosody/core/rostermanager.lua:275: attempt to concatenate a nil value (local 'username')
stack traceback:
/usr/lib/prosody/core/rostermanager.lua:275: in function 'prosody.core.rostermanager.is_user_subscribed'
...ules/mod_report_affiliations/mod_report_affiliations.lua:116: in field '?'
/usr/lib/prosody/util/events.lua:81: in function </usr/lib/prosody/util/events.lua:77>
(...tail calls...)
/usr/lib/prosody/core/stanza_router.lua:184: in upvalue 'core_post_stanza'
/usr/lib/prosody/modules/mod_presence.lua:244: in function </usr/lib/prosody/modules/mod_presence.lua:231>
(...tail calls...)
/usr/lib/prosody/util/events.lua:81: in function </usr/lib/prosody/util/events.lua:77>
(...tail calls...)
/usr/lib/prosody/core/stanza_router.lua:188: in upvalue 'core_post_stanza'
/usr/lib/prosody/core/stanza_router.lua:128: in upvalue 'core_process_stanza'
/usr/lib/prosody/modules/mod_s2s.lua:818: in upvalue 'func'
/usr/lib/prosody/util/async.lua:149: in function </usr/lib/prosody/util/async.lua:147>
| author | Link Mauve <linkmauve@linkmauve.fr> |
|---|---|
| date | Tue, 30 Dec 2025 13:19:43 +0100 |
| parents | fe081789f7b5 |
| children |
| rev | line source |
|---|---|
| 1803 | 1 --- |
| 2 labels: | |
| 3 - 'Stage-Beta' | |
| 4 summary: Manage rosters through prosodyctl | |
| 5 ... | |
| 6 | |
| 7 Introduction | |
| 8 ------------ | |
| 9 | |
| 10 This module allows you to perform various actions on user rosters via | |
| 11 prosodyctl. | |
| 12 | |
| 13 Details | |
| 14 ------- | |
| 15 | |
| 16 After putting this module in your modules directory you can use it via | |
| 17 prosodyctl like this: | |
| 18 | |
|
1820
8de50be756e5
Various README files: Correct indentation levels, fix syntax and other small fixes
Kim Alvefur <zash@zash.se>
parents:
1803
diff
changeset
|
19 prosodyctl mod_roster_command COMMAND [OPTIONS...] |
| 1803 | 20 |
| 21 **Note:** Do not add mod\_roster\_command to your Prosody config file. | |
| 22 This is unnecessary because it will automatically be loaded by | |
| 23 prosodyctl when you use it. | |
| 24 | |
| 25 ### Commands | |
| 26 | |
|
1820
8de50be756e5
Various README files: Correct indentation levels, fix syntax and other small fixes
Kim Alvefur <zash@zash.se>
parents:
1803
diff
changeset
|
27 subscribe user@host contact@host |
| 1803 | 28 |
| 29 Subscribes the user to the contact's presence. That is, the user will | |
| 30 see when the contact is online (but the contact won't see the user). | |
| 31 | |
|
1820
8de50be756e5
Various README files: Correct indentation levels, fix syntax and other small fixes
Kim Alvefur <zash@zash.se>
parents:
1803
diff
changeset
|
32 subscribe_both user@host contact@host |
| 1803 | 33 |
| 34 The same as the 'subscribe' command, but performs the subscription in | |
| 35 both directions, so that both the contact and user will always see each | |
| 36 other online. | |
| 37 | |
|
1820
8de50be756e5
Various README files: Correct indentation levels, fix syntax and other small fixes
Kim Alvefur <zash@zash.se>
parents:
1803
diff
changeset
|
38 unsubscribe user@host contact@host |
| 1803 | 39 |
| 40 Removes a subscription to the contact's presence. | |
| 41 | |
|
1820
8de50be756e5
Various README files: Correct indentation levels, fix syntax and other small fixes
Kim Alvefur <zash@zash.se>
parents:
1803
diff
changeset
|
42 unsubscribe_both user@host contact@host |
| 1803 | 43 |
| 44 Same as unsubscribe, but also revokes a contact's subscription to the | |
| 45 user's presence. | |
| 46 | |
|
1820
8de50be756e5
Various README files: Correct indentation levels, fix syntax and other small fixes
Kim Alvefur <zash@zash.se>
parents:
1803
diff
changeset
|
47 rename user@host contact@host [name] [group] |
| 1803 | 48 |
| 49 Sets or updates a name for a contact in the user's roster, and moves the | |
| 50 contact to the given group, if specified. | |
| 51 | |
| 52 Compatibility | |
| 53 ------------- | |
| 54 | |
| 55 ----- ------- | |
| 56 0.9 Works | |
| 57 0.8 Works | |
| 58 ----- ------- |