1SENDXMPP(1) User Contributed Perl Documentation SENDXMPP(1)
2
3
4
5sendxmpp - send xmpp messages from the commandline.
6
8 sendxmpp [options] <recipient>
9
11 sendxmpp is a program to send XMPP (Jabber) messages from the
12 commandline, not unlike mail(1). Messages can be sent both to
13 individual recipients and chatrooms.
14
16 -f,--file <file> use <file> configuration file instead of ~/.sendxmpprc
17
18 -u,--username <user> use <user> instead of the one in the configuration
19 file
20
21 -p,--password <password> use <password> instead of the one in the
22 configuration file
23
24 -j,--jserver <server> use jabber server <server> instead of the one in
25 the configuration file. Note that you can add :<port> to use a non-
26 default port, ie. -j myjabber.org:1234
27
28 -r,--resource <res> use resource <res> for the sender [default:
29 'sendxmpp']; when sending to a chatroom, this determines the 'alias'
30
31 -t,--tls connect securely, using TLS
32
33 -c,--chatroom send the message to a chatroom
34
35 -s,--subject <subject> set the subject for the message to <subject>
36 [default: '']; when sending to a chatroom, this will set the subject
37 for the chatroom
38
39 -m,--message <message> read the message from <message> (a file) instead
40 of stdin
41
42 -i,--interactive work in interactive mode, reading lines from stdin and
43 sending the one-at-time
44
45 -v,--verbose give verbose output about what is happening
46
47 -h,--help,--usage show a 'Usage' message
48
49 -d,--debug show debugging info while running. WARNING: This will
50 include passwords etc. so be careful with the output!
51
53 You may define a '~/.sendxmpprc' file with the necessary data for your
54 xmpp-account, with a line of the format:
55
56 <user>@<host> <password>
57
58 e.g.:
59
60 # my account
61 alice@jabber.org secret
62
63 ('#' and newlines are allowed like in shellscripts). You can add
64 :<port> to the <host> if you need an alternative port, ie.
65
66 # account with weird port number
67 alice@myjabberhost.com:1234 secret
68
69 NOTE: for your security, sendxmpp demands that the configuration file
70 is owned by you and has file permissions 600.
71
73 $ echo "hello bob!" | sendxmpp -s hello someone@jabber.org
74
75 or to send to a chatroom:
76
77 $ echo "Dinner Time" | sendxmpp -r TheCook --chatroom test2@conference.jabber.org
78
79 or to send your system logs somewhere, as new lines appear:
80
81 $ tail -f /var/log/syslog | sendxmpp -i sysadmin@myjabberserver.com
82
83 NOTE: be careful not the overload public jabber services
84
86 Documentation for the Net::XMPP module
87
88 The jabber homepage: http://www.jabber.org/
89
90 The sendxmpp homepage: http://www.djcbsoftware.nl/code/sendxmpp
91
93 sendxmpp has been written by Dirk-Jan C. Binnema
94 <djcb@djcbsoftware.nl>, and uses the Net::XMPP modules written by Ryan
95 Eatmon.
96
98 Hey! The above document had some coding errors, which are explained
99 below:
100
101 Around line 431:
102 =pod directives shouldn't be over one line long! Ignoring all 2
103 lines of content
104
105
106
107perl v5.10.0 2005-05-07 SENDXMPP(1)