sendxmpp

Langue: en

Version: 2005-05-07 (fedora - 01/12/10)

Section: 1 (Commandes utilisateur)

sendxmpp - send xmpp messages from the commandline.

SYNOPSIS

sendxmpp [options] <recipient>

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

-j,--jserver <server> use jabber server <server> instead of the one in the configuration file. Note that you can add :<port> to use a non-default port, ie. -j myjabber.org:1234

-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

-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

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

CONFIGURATION FILE

You may define a '~/.sendxmpprc' file with the necessary data for your xmpp-account, with a line of the format:
    <user>@<host> <password>
 
 

e.g.:

     # my account
     alice@jabber.org  secret
 
 

('#' and newlines are allowed like in shellscripts). You can add :<port> to the <host> if you need an alternative port, ie.

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

NOTE: for your security, sendxmpp demands that the configuration file is owned by you and has file 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://www.djcbsoftware.nl/code/sendxmpp

AUTHOR

sendxmpp has been written by Dirk-Jan C. Binnema <djcb@djcbsoftware.nl>, and uses the Net::XMPP modules written by Ryan Eatmon.

POD ERRORS

Hey! The above document had some coding errors, which are explained below:
Around line 431:
=pod directives shouldn't be over one line long! Ignoring all 2 lines of content