SENDXMPP(1)

NAME
sendxmpp - send xmpp messages from the commandline.

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

sendxmpp --raw [options]

DESCRIPTION
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.

OPTIONS

-f, --file file
    Use file configuration file instead of ~/.sendxmpprc

-u, --username user
    Use user instead of the one in the configuration file

-p, --password password
    Use password instead of the one in the configuration file

--sso
    Instead of specifying username or password, attempt to use system level SSO (e.g. kerberos) if supported.

-j, --jserver server
    Use jabber server instead of the one in the configuration file.

-o, --component componentname
    Use componentname in connect call. Seems needed for Google talk.

-r, --resource res
    Use resource res for the sender [default: 'sendxmpp']; when sending to a chatroom, this determines the 'alias'

-t, --tls
    Connect securely, using TLS

-e, --ssl
    Connect securely, using SSL

-n, --no-tls-verify
    Deactivate the verification of SSL certificates. Better way is to use parameter --tls-ca-path with the needed path to CA certificates.

-a, --tls-ca-path
    Path to your custom CA certificates, so you can verificate SSL certificates during connecting.

--http
    Connect over HTTP, allowing the use of a proxy.

-l, --headline
    Backward compatibility option. You should use --message-type=headline instead. Send a headline type message (not stored in offline messages)

--message-type
    Set type of message. Supported types are: chat error groupchat headline normal. Default message type is chat. Headline type message can be set also with --headline option, see --headline

-c, --chatroom
    Send the message to a chatroom

-s, --subject subject
    Set the subject for the message to subject [default: '']; when sending to a chatroom, this will set the subject for the chatroom

-m, --message message
    Read the message from message (a file) instead of stdin

-i, --interactive
    Work in interactive mode, reading lines from stdin and sending the one-at-time

-w, --raw
    Send raw XML message to jabber server

-v, --verbose
    Give verbose output about what is happening

-h, --help, --usage
    Show a 'Usage' message

-d, --debug
    Show debugging info while running. WARNING: This will include passwords etc. so be careful with the output! Specify multiple times to increase debug level.

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

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

Example for Google Talk servers:

    username: <lubomir.host>
    jserver: <talk.google.com>
    password: <my-secure-password>
    component: <gmail.com>

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

    user@server password componentname

e.g.:

    # my account
    alice@jabber.org  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
    alice@myjabberserver.com;foo.com secret

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

    # account with weird port number
    alice@myjabberserver.com:1234 secret

Of course, you may also mix the two:

    # account with a specific host and port
    alice@myjabberserver.com;foo.com:1234 secret

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

EXAMPLE
   $ echo "hello bob!" | sendxmpp -s hello someone@jabber.org

     or to send to a chatroom:

   $ echo "Dinner Time" | sendxmpp -r TheCook --chatroom test2@conference.jabber.org

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

   $ tail -f /var/log/syslog | sendxmpp -i sysadmin@myjabberserver.com

     NOTE: be careful not the overload public jabber services

SEE ALSO
Documentation for the Net::XMPP module

The jabber homepage: <http://www.jabber.org/>

The sendxmpp homepage: <http://sendxmpp.hostname.sk>

AUTHOR
sendxmpp has been written by Dirk-Jan C. Binnema <djcb@djcbsoftware.nl>, and uses the Net::XMPP modules written by Ryan Eatmon. Current maintainer is Lubomir Host <lubomir.host@gmail.com>, <http://blog.hostname.sk>