mirror of
https://salsa.debian.org/mdosch/go-sendxmpp
synced 2024-11-18 21:25:31 +00:00
78 lines
5.2 KiB
Groff
78 lines
5.2 KiB
Groff
.\" generated with Ronn-NG/v0.9.1
|
|
.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
|
|
.TH "GO\-SENDXMPP" "1" "July 2022" ""
|
|
.SH "NAME"
|
|
\fBgo\-sendxmpp\fR \- A little tool to send messages to an XMPP contact or MUC\.
|
|
.SH "SYNOPSIS"
|
|
\fBgo\-sendxmpp\fR [\-cdintx] [\-f value] [\-\-help] [\-j value] [\-m value] [\-p value] [\-r value] [\-u value] [parameters \|\.\|\.\|\.]
|
|
.SH "DESCRIPTION"
|
|
A little tool to send messages to an XMPP contact or MUC inspired by (but not as powerful as) \fBsendxmpp\fR\.
|
|
.br
|
|
You can either pipe a programs output to \fBgo\-sendxmpp\fR, write in your terminal (put \fB^D\fR in a new line to finish) or send the input from a file (\fB\-m\fR or \fB\-\-message\fR)\. The account data is expected at \fB~/\.config/go\-sendxmpp/config\fR (preferred), \fB~/\.config/go\-sendxmpp/sendxmpprc\fR (deprecated) \fB~/\.sendxmpprc\fR (for compatibility with the original perl sendxmpp) if no other configuration file location is specified with \fB\-f\fR or \fB\-\-file\fR\.
|
|
.SH "OPTIONS"
|
|
\fB\-c\fR, \fB\-\-chatroom\fR=[\fIvalue\fR]: Send message to a chatroom\.
|
|
.P
|
|
\fB\-d\fR, \fB\-\-debug\fR: Show debugging info\.
|
|
.P
|
|
\fB\-f\fR, \fB\-\-file\fR=[\fIvalue\fR]: Set configuration file\. (Default: ~/\.config/go\-sendxmpp/config)
|
|
.P
|
|
\fB\-\-help\fR: Show help\.
|
|
.P
|
|
\fB\-\-http\-upload=\fR[\fIvalue\fR]: Send a file via http\-upload\.
|
|
.P
|
|
\fB\-i\fR, \fB\-\-interactive\fR: Interactive mode (for use with e\.g\. \fBtail \-f\fR)\.
|
|
.P
|
|
\fB\-j\fR, \fB\-\-jserver\fR=[\fIvalue\fR]: XMPP server address\.
|
|
.P
|
|
\fB\-l\fR, \fB\-\-listen\fR: Listen for messages and print them to stdout\. If JIDs are specified only messages from those contacts are shown\. If no JIDs are specified all received messages will be shown\.
|
|
.P
|
|
\fB\-m\fR, \fB\-\-message\fR=[\fIvalue\fR]: Set file including the message\.
|
|
.P
|
|
\fB\-\-muc\-password\fR=[\fIvalue\fR]: Password for password protected MUCs\.
|
|
.P
|
|
\fB\-n\fR, \fB\-\-no\-tls\-verify\fR: Skip verification of TLS certificates (not recommended)\.
|
|
.P
|
|
\fB\-\-ox\fR: Use "OpenPGP for XMPP" encryption (experimental)\.
|
|
.br
|
|
Ox in go\-sendxmpp only supports sending encrypted 1\-1 messages\. Sending to groupchats and sending encrypted files is not supported\. There is no check whether the recipients key is trusted as there is no local keyring used\. Go\-sendxmpp just uses the most recent key that is provided via pubsub and checks that it is not expired\. As a user facing client a notification would be shown that a new key is available and ask the user whether to use the new key or stick to the old one\. As go\-sendxmpp is usually used in scripts it just accepts the new key to prevent the user from missing a new notification due to changed keys\.
|
|
.P
|
|
\fB\-\-ox\-delete\-nodes\fR: Delete existing OpenPGP nodes on the server\.
|
|
.P
|
|
\fB\-\-ox\-genprivkey\-rsa\fR: Generate a private OpenPGP key (RSA 4096 bit) for the configured account (via config file or \fB\-u\fR and \fB\-p\fR) and publish the corresponding public key\. Go\-sendxmpp will save the key in \fB$XDG_DATA_HOME/go\-sendxmpp/oxprivkeys\fR or \fB$HOME/\.local/share/go\-sendxmpp/oxprivkeys\fR\. To protect the key a passphrase might be set using \fB\-\-ox\-passphrase\fR while generating the key\.
|
|
.br
|
|
If there is an existing private key for "OpenPGP for XMPP" created by another client (e\.g\. profanity) it might be imported using \fB\-\-ox\-import\-privkey\fR\.
|
|
.P
|
|
\fB\-\-ox\-genprivkey\-x25519\fR: Generate a private OpenPGP key (X25519) for the configured account (via config file or \fB\-u\fR and \fB\-p\fR) and publish the corresponding public key\. Go\-sendxmpp will save the key in \fB$XDG_DATA_HOME/go\-sendxmpp/oxprivkeys\fR or \fB$HOME/\.local/share/go\-sendxmpp/oxprivkeys\fR\. To protect the key a passphrase might be set using \fB\-\-ox\-passphrase\fR while generating the key\.
|
|
.br
|
|
If there is an existing private key for "OpenPGP for XMPP" created by another client (e\.g\. profanity) it might be imported using \fB\-\-ox\-import\-privkey\fR\.
|
|
.P
|
|
\fB\-\-ox\-import\-privkey\fR=[\fIvalue\fR]: Import an existing private OpenPGP key\.
|
|
.P
|
|
\fB\-\-ox\-passphrase\fR=[\fIvalue\fR]: Passphrase for locking and unlocking the private OpenPGP key\.
|
|
.P
|
|
\fB\-\-tls\-version\fR=[\fIvalue\fR]: Minimal TLS version\. 10 (TLSv1\.0), 11 (TLSv1\.1), 12 (TLSv1\.2), 13 (TLSv1\.3) (Default: 12)
|
|
.P
|
|
\fB\-p\fR, \fB\-\-password\fR=[\fIvalue\fR]: Password for XMPP account\.
|
|
.P
|
|
\fB\-\-raw\fR: Send raw XML\. To send raw XML to a contact as normal chat message no contact must be specified\. To send raw XML to a MUC you have to specify the MUC via \fB\-c\fR and go\-sendxmpp will join the MUC\.
|
|
.P
|
|
\fB\-r\fR, \fB\-\-resource\fR=[\fIvalue\fR]: Set resource\. When sending to a chatroom this is used as 'alias'\.
|
|
.P
|
|
\fB\-\-timeout=\fR[\fIvalue\fR]: Connection timeout in seconds\. (Default: 10)
|
|
.P
|
|
\fB\-t\fR, \fB\-\-tls\fR: Use direct TLS\.
|
|
.P
|
|
\fB\-u\fR, \fB\-\-username\fR=[\fIvalue\fR]: Username for XMPP account (JID)\.
|
|
.P
|
|
\fB\-\-version\fR: Show version information\.
|
|
.SH "CHAT"
|
|
Feel free to join \fIhttps://join\.jabber\.network/#go\-sendxmpp@chat\.mdosch\.de?join\fR\.
|
|
.SH "AUTHOR"
|
|
Written by Martin Dosch\.
|
|
.SH "REPORTING BUGS"
|
|
Report bugs at \fIhttps://salsa\.debian\.org/mdosch/go\-sendxmpp/issues\fR\.
|
|
.SH "COPYRIGHT"
|
|
Copyright (c) 2018 \- 2021 Martin Dosch License: BSD 2\-clause License
|
|
.SH "SEE ALSO"
|
|
go\-sendxmpp(5), sendxmpp(1)
|