SENDXMPP(1)
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
- -l,--headline
- Send a headline type message (not stored in offline messages)
- -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>
POD ERRORS
Hey! The above document had some coding errors, which are explained
below:
- Around line 520:
- =pod directives shouldn't be over one line long! Ignoring all 2
lines of content