ref: ed2752fe715680692023bbcaf85ddf03c2444c2c
dir: xmpp/xmpp.man
.TH XMPP 1
.SH NAME
xmpp \- XMPP client
.SH SYNOPSIS
.B xmpp
[
.I -n nick
]
[
.I -r resource
]
[
.I -p
]
[
.I -h
]
[
.I -y
]
.I jid | jid@server
.SH DESCRIPTION
.I xmpp
is a simple XMPP client.
.PP
It supports multi-user chat (MUC).
Server-side bookmarks are used to join specific MUCs
automatically on connect. TLS is required, SCRAM-SHA-1,
DIGEST-MD5 and PLAIN authentication methods are supported.
The latter is enabled using
.I -y
option. Thumbprints of trusted servers are expected to be in
.I /sys/lib/tls/xmpp,
see
.IR thumbprint(6) .
.PP
.I -p
enables "joined"/"left" messages, which are disabled by default.
.PP
.I -h
allows MUCs to send out "discussion history".
.PP
The command language understood by
.I xmpp
is as follows:
.EX
/j [jid[/nick] [passwd]]
.EE
join MUC
.EX
/p [target]
.EE
part MUC
.EX
/q data
.EE
send raw data to the server
.EX
/t target
.EE
cycle through matching targets
.EX
/w [target]
.EE
get list of active nicks in the MUC
.EX
/W [target]
.EE
get list of all nicks in the MUC
.EX
/b
.EE
list bookmarked MUCs
.EX
/b+
.EE
bookmark current MUC
.EX
/b-
.EE
remove current MUC from bookmarks
.EX
/a target affiliation
.EE
set affiliation (for a target in MUC)
.EX
/a [room]
.EE
get affiliations for a room (current one if no args given)
.EX
/me ...
.EE
"/me"-style message
.EX
/m
.EE
start multiline message (end with a dot on a single line)
.EX
/n nick
.EE
set nick for current MUC
.EX
/r
.EE
show roster (list online contacts)
.EX
/R
.EE
show roster (show offline and jids)
.EX
/r+ (jid|target) [name]
.EE
subscribe/approve, add to roster
.EX
/r- target
.EE
unsubscribe/decline, remove from roster
.EX
/s [room]
.EE
show current subject
.EX
/S [room]
.EE
start new subject (end with a dot on a single line)
.PP
Affiliations are: none, owner, admin, member, outcast.
.PP
The target can be specified as follows:
.EX
room@domain a specific room
room@domain/nick private chat (MUC)
Wernher private chat (roster, name)
wernher@paperclip.gov private chat (roster, jid)
.EE
.PP
Assuming you previously joined a MUC
.I pravda@cc.cpsu.su,
you can quickly switch to private chat with
.I kgbvax
as follows:
.EX
/t pravda/kgbvax
/t pr/kgb
/t p/k
.EE
.SH SOURCE
https://git.sr.ht/~ft/xmpp
.SH BUGS
Of course.
.SH NOTES
XMPP sucks. XML sucks.