shithub: xmpp

ref: 38fbed97371f4f970a542945883e7d68762a2184
dir: /xmpp.man/

View raw version
.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]
	get list of all nicks in the MUC
.EE
.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
.PP
.SH SOURCE
https://github.com/ftrvxmtrx/xmpp
.SH BUGS
Of course.
.SH NOTES
XMPP sucks. XML sucks.