GSP
Quick Navigator

Search Site

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

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  SENDXMPP (1)

.ds Aq ’

NAME

sendxmpp - send xmpp messages from the commandline.

CONTENTS

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

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

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: 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<lubomir.host>
    jserver: I<talk.google.com>
    password: I<my-secure-password>
    component: I<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



<B>NOTEB>: 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>
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.