SENDXMPP(1)						User Contributed Perl Documentation					       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

       -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

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

       --messages-type
	   Set type of message. Supported types are: message chat headline. Default message type is message. 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!

CONFIGURATION FILE

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

	   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.platon.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 'rajo' <rajo AT platon.sk>, <http://rajo.platon.sk>

perl v5.12.4							    2010-12-31							       SENDXMPP(1)