Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages

Manual Reference Pages  -  SENDXMPP (1)

.ds Aq ’


sendxmpp - send xmpp messages from the commandline.



sendxmpp [options] <recipient1> [<recipient2> ...]

sendxmpp --raw [options]


sendxmpp is a program to send XMPP (Jabber) messages from the commandline, not unlike mail(1). Messages can be sent both to individual recipients and chatrooms.


<B>-fB>,<B>--fileB> file Use file configuration file instead of ~/.sendxmpprc
<B>-uB>,<B>--usernameB> user Use user instead of the one in the configuration file
<B>-pB>,<B>--passwordB> password Use password instead of the one in the configuration file
<B>--ssoB> Instead of specifying username or password, attempt to use system level SSO (e.g. kerberos) if supported.
<B>-jB>,<B>--jserverB> server Use jabber server instead of the one in the configuration file.
<B>-oB>,<B>--componentB> componentname Use componentname in connect call. Seems needed for Google talk.
<B>-rB>,<B>--resourceB> res Use resource res for the sender [default: ’sendxmpp’]; when sending to a chatroom, this determines the ’alias’
<B>-tB>,<B>--tlsB> Connect securely, using TLS
<B>-eB>,<B>--sslB> Connect securely, using SSL
<B>-nB>,<B>--no-tls-verifyB> Deactivate the verification of SSL certificates. Better way is to use parameter <B>--tls-ca-pathB> with the needed path to CA certificates.
<B>-aB>,<B>--tls-ca-pathB> Path to your custom CA certificates, so you can verificate SSL certificates during connecting.
<B>-lB>,<B>--headlineB> Backward compatibility option. You should use <B>--message-type=headlineB> instead. Send a headline type message (not stored in offline messages)
<B>--messages-typeB> Set type of message. Supported types are: <B>message chat headlineB>. Default message type is <B>messageB>. Headline type message can be set also with <B>--headlineB> option, see <B>--headlineB>
<B>-cB>,<B>--chatroomB> Send the message to a chatroom
<B>-sB>,<B>--subjectB> subject Set the subject for the message to subject [default: ’’]; when sending to a chatroom, this will set the subject for the chatroom
<B>-mB>,<B>--messageB> message Read the message from message (a file) instead of stdin
<B>-iB>,<B>--interactiveB> Work in interactive mode, reading lines from stdin and sending the one-at-time
<B>-wB>,<B>--rawB> Send raw XML message to jabber server
<B>-vB>,<B>--verboseB> Give verbose output about what is happening
<B>-hB>,<B>--helpB>,<B>--usageB> Show a ’Usage’ message
<B>-dB>,<B>--debugB> Show debugging info while running. <B>WARNINGB>: This will include passwords etc. so be careful with the output! Specify multiple times to increase debug level.


You may define a ’~/.sendxmpprc’ file with the necessary data for your xmpp-account. Since version 1.24 the following format is supported:

    username: I<your_username>
    jserver: I<jabber_server>
    port: I<jabber_port>
    password: I<your_jabber_password>
    component: I<optional_component_name>

Example for Google Talk servers:

    username: I<>
    jserver: I<>
    password: I<my-secure-password>
    component: I<>

With version 1.23 and older only one-line format is supported:

user@server password componentname


    # my account  secret

(’#’ and newlines are allowed like in shellscripts). You can add a host (or IP address) if it is different from the server part of your JID:

    # account with specific connection host; secret

You can also add a port if it is not the standard XMPP port:

    # account with weird port number secret

Of course, you may also mix the two:

    # account with a specific host and port; secret

<B>NOTEB>: for your security, sendxmpp demands that the configuration file is owned by you and readable only to you (permissions 600).


   $ echo "hello bob!" | sendxmpp -s hello

     or to send to a chatroom:

   $ echo "Dinner Time" | sendxmpp -r TheCook --chatroom

     or to send your system logs somewhere, as new lines appear:

   $ tail -f /var/log/syslog | sendxmpp -i

     NOTE: be careful not the overload public jabber services


Documentation for the Net::XMPP module

The jabber homepage: <>

The sendxmpp homepage: <>


sendxmpp has been written by Dirk-Jan C. Binnema <>, and uses the Net::XMPP modules written by Ryan Eatmon. Current maintainer is Lubomir Host <>, <>
Search for    or go to Top of page |  Section 1 |  Main Index

perl v5.20.3 SENDXMPP (1) 2014-09-13

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.