1SENDXMPP(1)           User Contributed Perl Documentation          SENDXMPP(1)
2
3
4

NAME

6       sendxmpp - send xmpp messages from the commandline.
7

SYNOPSIS

9       sendxmpp [options] <recipient1> [<recipient2> ...]
10
11       sendxmpp --raw [options]
12

DESCRIPTION

14       sendxmpp is a program to send XMPP (Jabber) messages from the
15       commandline, not unlike mail(1). Messages can be sent both to
16       individual recipients and chatrooms.
17

OPTIONS

19       -f,--file file
20           Use file configuration file instead of ~/.sendxmpprc
21
22       -u,--username user
23           Use user instead of the one in the configuration file
24
25       -p,--password password
26           Use password instead of the one in the configuration file
27
28       --sso
29           Instead of specifying username or password, attempt to use system
30           level SSO (e.g. kerberos) if supported.
31
32       -j,--jserver server
33           Use jabber server instead of the one in the configuration file.
34
35       -o,--component componentname
36           Use componentname in connect call. Seems needed for Google talk.
37
38       -r,--resource res
39           Use resource res for the sender [default: 'sendxmpp']; when sending
40           to a chatroom, this determines the 'alias'
41
42       -t,--tls
43           Connect securely, using TLS
44
45       -e,--ssl
46           Connect securely, using SSL
47
48       -n,--no-tls-verify
49           Deactivate the verification of SSL certificates. Better way is to
50           use parameter --tls-ca-path with the needed path to CA
51           certificates.
52
53       -a,--tls-ca-path
54           Path to your custom CA certificates, so you can verificate SSL
55           certificates during connecting.
56
57       -l,--headline
58           Backward compatibility option. You should use
59           --message-type=headline instead. Send a headline type message (not
60           stored in offline messages)
61
62       --messages-type
63           Set type of message. Supported types are: message chat headline.
64           Default message type is message. Headline type message can be set
65           also with --headline option, see --headline
66
67       -c,--chatroom
68           Send the message to a chatroom
69
70       -s,--subject subject
71           Set the subject for the message to subject [default: '']; when
72           sending to a chatroom, this will set the subject for the chatroom
73
74       -m,--message message
75           Read the message from message (a file) instead of stdin
76
77       -i,--interactive
78           Work in interactive mode, reading lines from stdin and sending the
79           one-at-time
80
81       -w,--raw
82           Send raw XML message to jabber server
83
84       -v,--verbose
85           Give verbose output about what is happening
86
87       -h,--help,--usage
88           Show a 'Usage' message
89
90       -d,--debug
91           Show debugging info while running. WARNING: This will include
92           passwords etc. so be careful with the output! Specify multiple
93           times to increase debug level.
94

CONFIGURATION FILE

96       You may define a '~/.sendxmpprc' file with the necessary data for your
97       xmpp-account. Since version 1.24 the following format is supported:
98
99           username: I<your_username>
100           jserver: I<jabber_server>
101           port: I<jabber_port>
102           password: I<your_jabber_password>
103           component: I<optional_component_name>
104
105       Example for Google Talk servers:
106
107           username: I<lubomir.host>
108           jserver: I<talk.google.com>
109           password: I<my-secure-password>
110           component: I<gmail.com>
111
112       With version 1.23 and older only one-line format is supported:
113
114           user@server password componentname
115
116       e.g.:
117
118           # my account
119           alice@jabber.org  secret
120
121       ('#' and newlines are allowed like in shellscripts). You can add a host
122       (or IP address) if it is different from the server part of your JID:
123
124           # account with specific connection host
125           alice@myjabberserver.com;foo.com secret
126
127       You can also add a port if it is not the standard XMPP port:
128
129           # account with weird port number
130           alice@myjabberserver.com:1234 secret
131
132       Of course, you may also mix the two:
133
134           # account with a specific host and port
135           alice@myjabberserver.com;foo.com:1234 secret
136
137       NOTE: for your security, sendxmpp demands that the configuration file
138       is owned by you and readable only to you (permissions 600).
139

EXAMPLE

141          $ echo "hello bob!" | sendxmpp -s hello someone@jabber.org
142
143            or to send to a chatroom:
144
145          $ echo "Dinner Time" | sendxmpp -r TheCook --chatroom test2@conference.jabber.org
146
147            or to send your system logs somewhere, as new lines appear:
148
149          $ tail -f /var/log/syslog | sendxmpp -i sysadmin@myjabberserver.com
150
151            NOTE: be careful not the overload public jabber services
152

SEE ALSO

154       Documentation for the Net::XMPP module
155
156       The jabber homepage: <http://www.jabber.org/>
157
158       The sendxmpp homepage: <http://sendxmpp.hostname.sk>
159

AUTHOR

161       sendxmpp has been written by Dirk-Jan C. Binnema
162       <djcb@djcbsoftware.nl>, and uses the Net::XMPP modules written by Ryan
163       Eatmon. Current maintainer is Lubomir Host <lubomir.host@gmail.com>,
164       <http://blog.hostname.sk>
165
166
167
168perl v5.28.0                      2014-09-13                       SENDXMPP(1)
Impressum