Improve manpage formatting.

v0.5
Martin Dosch 2 years ago
parent 49d35a864c
commit f03be57a8d
No known key found for this signature in database
GPG Key ID: 52A57CFCE13D657D

@ -1,6 +1,6 @@
.\" generated with Ronn-NG/v0.9.1
.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
.TH "GO\-SENDXMPP" "1" "September 2022" ""
.TH "GO\-SENDXMPP" "1" "November 2022" ""
.SH "NAME"
\fBgo\-sendxmpp\fR \- A tool to send messages to an XMPP contact or MUC\.
.SH "SYNOPSIS"
@ -10,63 +10,142 @@ A tool to send messages to an XMPP contact or MUC inspired by (but not as powerf
.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\-a\fR, \fB\-\-alias\fR=[\fIvalue\fR]: Set alias/nickname for chatrooms\.
.P
\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)\.
.TP
\fB\-a\fR, \fB\-\-alias\fR=[\fIvalue\fR]:
.P
Set alias/nickname for chatrooms\.
.TP
\fB\-c\fR, \fB\-\-chatroom\fR=[\fIvalue\fR]:
.P
Send message to a chatroom\.
.TP
\fB\-d\fR, \fB\-\-debug\fR:
.P
Show debugging info\.
.TP
\fB\-f\fR, \fB\-\-file\fR=[\fIvalue\fR]:
.P
Set configuration file\. (Default: ~/\.config/go\-sendxmpp/config)
.TP
\fB\-\-help\fR:
.P
Show help\.
.TP
\fB\-\-http\-upload=\fR[\fIvalue\fR]:
.P
Send a file via http\-upload\.
.TP
\fB\-i\fR, \fB\-\-interactive\fR:
.P
Interactive mode (for use with e\.g\. \fBtail \-f\fR)\.
.TP
\fB\-j\fR, \fB\-\-jserver\fR=[\fIvalue\fR]:
.P
XMPP server address\.
.TP
\fB\-l\fR, \fB\-\-listen\fR:
.P
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\.
.TP
\fB\-m\fR, \fB\-\-message\fR=[\fIvalue\fR]:
.P
Set file including the message\.
.TP
\fB\-\-muc\-password\fR=[\fIvalue\fR]:
.P
Password for password protected MUCs\.
.TP
\fB\-n\fR, \fB\-\-no\-tls\-verify\fR:
.P
Skip verification of TLS certificates (not recommended)\.
.TP
\fB\-\-ox\fR:
.P
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\.
.TP
\fB\-\-ox\-delete\-nodes\fR:
.P
\fB\-\-ox\-delete\-nodes\fR: Delete existing OpenPGP nodes on the server\.
Delete existing OpenPGP nodes on the server\.
.TP
\fB\-\-ox\-genprivkey\-rsa\fR:
.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\.
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\.
.TP
\fB\-\-ox\-genprivkey\-x25519\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\.
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]: DEPRECATED: 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\.
.TP
\fB\-\-ox\-import\-privkey\fR=[\fIvalue\fR]:
.P
Import an existing private OpenPGP key\.
.TP
\fB\-\-ox\-passphrase\fR=[\fIvalue\fR]:
.P
Passphrase for locking and unlocking the private OpenPGP key\.
.TP
\fB\-\-tls\-version\fR=[\fIvalue\fR]:
.P
Minimal TLS version\. 10 (TLSv1\.0), 11 (TLSv1\.1), 12 (TLSv1\.2), 13 (TLSv1\.3) (Default: 12)
.TP
\fB\-p\fR, \fB\-\-password\fR=[\fIvalue\fR]:
.P
Password for XMPP account\.
.TP
\fB\-\-raw\fR:
.P
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\.
.TP
\fB\-r\fR, \fB\-\-resource\fR=[\fIvalue\fR]:
.P
DEPRECATED: Set resource\. When sending to a chatroom this is used as 'alias'\.
.TP
\fB\-\-timeout=\fR[\fIvalue\fR]:
.P
Connection timeout in seconds\. (Default: 10)
.TP
\fB\-t\fR, \fB\-\-tls\fR:
.P
Use direct TLS\.
.TP
\fB\-u\fR, \fB\-\-username\fR=[\fIvalue\fR]:
.P
Username for XMPP account (JID)\.
.TP
\fB\-\-version\fR:
.P
Show version information\.
.SH "CHAT"
Feel free to join \fIhttps://join\.jabber\.network/#go\-sendxmpp@chat\.mdosch\.de?join\fR\.
.SH "AUTHOR"

@ -91,104 +91,235 @@ file location is specified with <code>-f</code> or <code>--file</code>.</p>
<h2 id="OPTIONS">OPTIONS</h2>
<p><code>-a</code>, <code>--alias</code>=[<var>value</var>]:
Set alias/nickname for chatrooms.</p>
<p><code>-c</code>, <code>--chatroom</code>=[<var>value</var>]:
Send message to a chatroom.</p>
<p><code>-d</code>, <code>--debug</code>:
Show debugging info.</p>
<p><code>-f</code>, <code>--file</code>=[<var>value</var>]:
Set configuration file. (Default: ~/.config/go-sendxmpp/config)</p>
<p><code>--help</code>:
Show help.</p>
<p><code>--http-upload=</code>[<var>value</var>]:
Send a file via http-upload.</p>
<p><code>-i</code>, <code>--interactive</code>:
Interactive mode (for use with e.g. <code>tail -f</code>).</p>
<p><code>-j</code>, <code>--jserver</code>=[<var>value</var>]:
XMPP server address.</p>
<p><code>-l</code>, <code>--listen</code>:
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>
<p><code>-m</code>, <code>--message</code>=[<var>value</var>]:
Set file including the message.</p>
<p><code>--muc-password</code>=[<var>value</var>]:
Password for password protected MUCs.</p>
<p><code>-n</code>, <code>--no-tls-verify</code>:
Skip verification of TLS certificates (not recommended).</p>
<p><code>--ox</code>:
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>
<p><code>--ox-delete-nodes</code>:
Delete existing OpenPGP nodes on the server.</p>
<p><code>--ox-genprivkey-rsa</code>:
Generate a private OpenPGP key (RSA 4096 bit) for the configured account (via config file or <code>-u</code> and <code>-p</code>)
and publish the corresponding public key.
Go-sendxmpp will save the key in <code>$XDG_DATA_HOME/go-sendxmpp/oxprivkeys</code> or
<code>$HOME/.local/share/go-sendxmpp/oxprivkeys</code>. To protect the key a passphrase might be set
using <code>--ox-passphrase</code> 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 <code>--ox-import-privkey</code>.</p>
<p><code>--ox-genprivkey-x25519</code>:
Generate a private OpenPGP key (X25519) for the configured account (via config file or <code>-u</code> and <code>-p</code>)
and publish the corresponding public key.
Go-sendxmpp will save the key in <code>$XDG_DATA_HOME/go-sendxmpp/oxprivkeys</code> or
<code>$HOME/.local/share/go-sendxmpp/oxprivkeys</code>. To protect the key a passphrase might be set
using <code>--ox-passphrase</code> 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 <code>--ox-import-privkey</code>.</p>
<p><code>--ox-import-privkey</code>=[<var>value</var>]:
Import an existing private OpenPGP key.</p>
<p><code>--ox-passphrase</code>=[<var>value</var>]:
Passphrase for locking and unlocking the private OpenPGP key.</p>
<p><code>--tls-version</code>=[<var>value</var>]:
Minimal TLS version. 10 (TLSv1.0), 11 (TLSv1.1), 12 (TLSv1.2), 13 (TLSv1.3) (Default: 12)</p>
<p><code>-p</code>, <code>--password</code>=[<var>value</var>]:
Password for XMPP account.</p>
<p><code>--raw</code>:
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 <code>-c</code> and go-sendxmpp will join the MUC.</p>
<p><code>-r</code>, <code>--resource</code>=[<var>value</var>]:
DEPRECATED: Set resource. When sending to a chatroom this is used as 'alias'.</p>
<p><code>--timeout=</code>[<var>value</var>]:
Connection timeout in seconds. (Default: 10)</p>
<p><code>-t</code>, <code>--tls</code>:
Use direct TLS.</p>
<p><code>-u</code>, <code>--username</code>=[<var>value</var>]:
Username for XMPP account (JID).</p>
<p><code>--version</code>: Show version information.</p>
<dl>
<dt>
<code>-a</code>, <code>--alias</code>=[<var>value</var>]:</dt>
<dd></dd>
</dl>
<p>Set alias/nickname for chatrooms.</p>
<dl>
<dt>
<code>-c</code>, <code>--chatroom</code>=[<var>value</var>]:</dt>
<dd></dd>
</dl>
<p>Send message to a chatroom.</p>
<dl>
<dt>
<code>-d</code>, <code>--debug</code>:</dt>
<dd></dd>
</dl>
<p>Show debugging info.</p>
<dl>
<dt>
<code>-f</code>, <code>--file</code>=[<var>value</var>]:</dt>
<dd></dd>
</dl>
<p>Set configuration file. (Default: ~/.config/go-sendxmpp/config)</p>
<dl>
<dt>
<code>--help</code>:</dt>
<dd></dd>
</dl>
<p>Show help.</p>
<dl>
<dt>
<code>--http-upload=</code>[<var>value</var>]:</dt>
<dd></dd>
</dl>
<p>Send a file via http-upload.</p>
<dl>
<dt>
<code>-i</code>, <code>--interactive</code>:</dt>
<dd></dd>
</dl>
<p>Interactive mode (for use with e.g. <code>tail -f</code>).</p>
<dl>
<dt>
<code>-j</code>, <code>--jserver</code>=[<var>value</var>]:</dt>
<dd></dd>
</dl>
<p>XMPP server address.</p>
<dl>
<dt>
<code>-l</code>, <code>--listen</code>:</dt>
<dd></dd>
</dl>
<p>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>
<dl>
<dt>
<code>-m</code>, <code>--message</code>=[<var>value</var>]:</dt>
<dd></dd>
</dl>
<p>Set file including the message.</p>
<dl>
<dt>
<code>--muc-password</code>=[<var>value</var>]:</dt>
<dd></dd>
</dl>
<p>Password for password protected MUCs.</p>
<dl>
<dt>
<code>-n</code>, <code>--no-tls-verify</code>:</dt>
<dd></dd>
</dl>
<p>Skip verification of TLS certificates (not recommended).</p>
<dl>
<dt>
<code>--ox</code>:</dt>
<dd></dd>
</dl>
<p>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>
<dl>
<dt>
<code>--ox-delete-nodes</code>:</dt>
<dd></dd>
</dl>
<p>Delete existing OpenPGP nodes on the server.</p>
<dl>
<dt>
<code>--ox-genprivkey-rsa</code>:</dt>
<dd></dd>
</dl>
<p>Generate a private OpenPGP key (RSA 4096 bit) for the configured account (via config file or <code>-u</code> and <code>-p</code>)
and publish the corresponding public key.
Go-sendxmpp will save the key in <code>$XDG_DATA_HOME/go-sendxmpp/oxprivkeys</code> or
<code>$HOME/.local/share/go-sendxmpp/oxprivkeys</code>. To protect the key a passphrase might be set
using <code>--ox-passphrase</code> 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 <code>--ox-import-privkey</code>.</p>
<dl>
<dt>
<code>--ox-genprivkey-x25519</code>:</dt>
<dd></dd>
</dl>
<p>Generate a private OpenPGP key (X25519) for the configured account (via config file or <code>-u</code> and <code>-p</code>)
and publish the corresponding public key.
Go-sendxmpp will save the key in <code>$XDG_DATA_HOME/go-sendxmpp/oxprivkeys</code> or
<code>$HOME/.local/share/go-sendxmpp/oxprivkeys</code>. To protect the key a passphrase might be set
using <code>--ox-passphrase</code> 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 <code>--ox-import-privkey</code>.</p>
<dl>
<dt>
<code>--ox-import-privkey</code>=[<var>value</var>]:</dt>
<dd></dd>
</dl>
<p>Import an existing private OpenPGP key.</p>
<dl>
<dt>
<code>--ox-passphrase</code>=[<var>value</var>]:</dt>
<dd></dd>
</dl>
<p>Passphrase for locking and unlocking the private OpenPGP key.</p>
<dl>
<dt>
<code>--tls-version</code>=[<var>value</var>]:</dt>
<dd></dd>
</dl>
<p>Minimal TLS version. 10 (TLSv1.0), 11 (TLSv1.1), 12 (TLSv1.2), 13 (TLSv1.3) (Default: 12)</p>
<dl>
<dt>
<code>-p</code>, <code>--password</code>=[<var>value</var>]:</dt>
<dd></dd>
</dl>
<p>Password for XMPP account.</p>
<dl>
<dt>
<code>--raw</code>:</dt>
<dd></dd>
</dl>
<p>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 <code>-c</code> and go-sendxmpp will join the MUC.</p>
<dl>
<dt>
<code>-r</code>, <code>--resource</code>=[<var>value</var>]:</dt>
<dd></dd>
</dl>
<p>DEPRECATED: Set resource. When sending to a chatroom this is used as 'alias'.</p>
<dl>
<dt>
<code>--timeout=</code>[<var>value</var>]:</dt>
<dd></dd>
</dl>
<p>Connection timeout in seconds. (Default: 10)</p>
<dl>
<dt>
<code>-t</code>, <code>--tls</code>:</dt>
<dd></dd>
</dl>
<p>Use direct TLS.</p>
<dl>
<dt>
<code>-u</code>, <code>--username</code>=[<var>value</var>]:</dt>
<dd></dd>
</dl>
<p>Username for XMPP account (JID).</p>
<dl>
<dt>
<code>--version</code>:</dt>
<dd></dd>
</dl>
<p>Show version information.</p>
<h2 id="CHAT">CHAT</h2>
@ -213,7 +344,7 @@ License: BSD 2-clause License</p>
<ol class='man-decor man-foot man foot'>
<li class='tl'></li>
<li class='tc'>September 2022</li>
<li class='tc'>November 2022</li>
<li class='tr'>go-sendxmpp(1)</li>
</ol>

@ -16,104 +16,131 @@ file location is specified with `-f` or `--file`.
## OPTIONS
`-a`, `--alias`=[<value>]:
Set alias/nickname for chatrooms.
* `-a`, `--alias`=[<value>]:
`-c`, `--chatroom`=[<value>]:
Send message to a chatroom.
Set alias/nickname for chatrooms.
`-d`, `--debug`:
Show debugging info.
* `-c`, `--chatroom`=[<value>]:
`-f`, `--file`=[<value>]:
Set configuration file. (Default: ~/.config/go-sendxmpp/config)
Send message to a chatroom.
`--help`:
Show help.
* `-d`, `--debug`:
`--http-upload=`[<value>]:
Send a file via http-upload.
Show debugging info.
`-i`, `--interactive`:
Interactive mode (for use with e.g. `tail -f`).
* `-f`, `--file`=[<value>]:
`-j`, `--jserver`=[<value>]:
XMPP server address.
Set configuration file. (Default: ~/.config/go-sendxmpp/config)
`-l`, `--listen`:
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.
* `--help`:
`-m`, `--message`=[<value>]:
Set file including the message.
Show help.
`--muc-password`=[<value>]:
Password for password protected MUCs.
* `--http-upload=`[<value>]:
`-n`, `--no-tls-verify`:
Skip verification of TLS certificates (not recommended).
Send a file via http-upload.
`--ox`:
Use "OpenPGP for XMPP" encryption (experimental).
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.
* `-i`, `--interactive`:
`--ox-delete-nodes`:
Delete existing OpenPGP nodes on the server.
Interactive mode (for use with e.g. `tail -f`).
`--ox-genprivkey-rsa`:
Generate a private OpenPGP key (RSA 4096 bit) for the configured account (via config file or `-u` and `-p`)
and publish the corresponding public key.
Go-sendxmpp will save the key in `$XDG_DATA_HOME/go-sendxmpp/oxprivkeys` or
`$HOME/.local/share/go-sendxmpp/oxprivkeys`. To protect the key a passphrase might be set
using `--ox-passphrase` while generating the key.
If there is an existing private key for "OpenPGP for XMPP" created by another client (e.g. profanity)
it might be imported using `--ox-import-privkey`.
* `-j`, `--jserver`=[<value>]:
`--ox-genprivkey-x25519`:
Generate a private OpenPGP key (X25519) for the configured account (via config file or `-u` and `-p`)
and publish the corresponding public key.
Go-sendxmpp will save the key in `$XDG_DATA_HOME/go-sendxmpp/oxprivkeys` or
`$HOME/.local/share/go-sendxmpp/oxprivkeys`. To protect the key a passphrase might be set
using `--ox-passphrase` while generating the key.
If there is an existing private key for "OpenPGP for XMPP" created by another client (e.g. profanity)
it might be imported using `--ox-import-privkey`.
XMPP server address.
`--ox-import-privkey`=[<value>]:
Import an existing private OpenPGP key.
* `-l`, `--listen`:
`--ox-passphrase`=[<value>]:
Passphrase for locking and unlocking the private OpenPGP key.
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.
`--tls-version`=[<value>]:
Minimal TLS version. 10 (TLSv1.0), 11 (TLSv1.1), 12 (TLSv1.2), 13 (TLSv1.3) (Default: 12)
* `-m`, `--message`=[<value>]:
`-p`, `--password`=[<value>]:
Password for XMPP account.
Set file including the message.
`--raw`:
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 `-c` and go-sendxmpp will join the MUC.
* `--muc-password`=[<value>]:
`-r`, `--resource`=[<value>]:
DEPRECATED: Set resource. When sending to a chatroom this is used as 'alias'.
Password for password protected MUCs.
`--timeout=`[<value>]:
Connection timeout in seconds. (Default: 10)
* `-n`, `--no-tls-verify`:
`-t`, `--tls`:
Use direct TLS.
Skip verification of TLS certificates (not recommended).
`-u`, `--username`=[<value>]:
Username for XMPP account (JID).
* `--ox`:
`--version`: Show version information.
Use "OpenPGP for XMPP" encryption (experimental).
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.
* `--ox-delete-nodes`:
Delete existing OpenPGP nodes on the server.
* `--ox-genprivkey-rsa`:
Generate a private OpenPGP key (RSA 4096 bit) for the configured account (via config file or `-u` and `-p`)
and publish the corresponding public key.
Go-sendxmpp will save the key in `$XDG_DATA_HOME/go-sendxmpp/oxprivkeys` or
`$HOME/.local/share/go-sendxmpp/oxprivkeys`. To protect the key a passphrase might be set
using `--ox-passphrase` while generating the key.
If there is an existing private key for "OpenPGP for XMPP" created by another client (e.g. profanity)
it might be imported using `--ox-import-privkey`.
* `--ox-genprivkey-x25519`:
Generate a private OpenPGP key (X25519) for the configured account (via config file or `-u` and `-p`)
and publish the corresponding public key.
Go-sendxmpp will save the key in `$XDG_DATA_HOME/go-sendxmpp/oxprivkeys` or
`$HOME/.local/share/go-sendxmpp/oxprivkeys`. To protect the key a passphrase might be set
using `--ox-passphrase` while generating the key.
If there is an existing private key for "OpenPGP for XMPP" created by another client (e.g. profanity)
it might be imported using `--ox-import-privkey`.
* `--ox-import-privkey`=[<value>]:
Import an existing private OpenPGP key.
* `--ox-passphrase`=[<value>]:
Passphrase for locking and unlocking the private OpenPGP key.
* `--tls-version`=[<value>]:
Minimal TLS version. 10 (TLSv1.0), 11 (TLSv1.1), 12 (TLSv1.2), 13 (TLSv1.3) (Default: 12)
* `-p`, `--password`=[<value>]:
Password for XMPP account.
* `--raw`:
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 `-c` and go-sendxmpp will join the MUC.
* `-r`, `--resource`=[<value>]:
DEPRECATED: Set resource. When sending to a chatroom this is used as 'alias'.
* `--timeout=`[<value>]:
Connection timeout in seconds. (Default: 10)
* `-t`, `--tls`:
Use direct TLS.
* `-u`, `--username`=[<value>]:
Username for XMPP account (JID).
* `--version`:
Show version information.
## CHAT

Loading…
Cancel
Save