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       --http
58           Connect over HTTP, allowing the use of a proxy.
59
60       -l, --headline
61           Backward compatibility option. You should use
62           --message-type=headline instead. Send a headline type message (not
63           stored in offline messages)
64
65       --messages-type
66           Set type of message. Supported types are: message chat headline.
67           Default message type is message. Headline type message can be set
68           also with --headline option, see --headline
69
70       -c, --chatroom
71           Send the message to a chatroom
72
73       -s, --subject subject
74           Set the subject for the message to subject [default: '']; when
75           sending to a chatroom, this will set the subject for the chatroom
76
77       -m, --message message
78           Read the message from message (a file) instead of stdin
79
80       -i, --interactive
81           Work in interactive mode, reading lines from stdin and sending the
82           one-at-time
83
84       -w, --raw
85           Send raw XML message to jabber server
86
87       -v, --verbose
88           Give verbose output about what is happening
89
90       -h, --help, --usage
91           Show a 'Usage' message
92
93       -d, --debug
94           Show debugging info while running. WARNING: This will include
95           passwords etc. so be careful with the output! Specify multiple
96           times to increase debug level.
97

CONFIGURATION FILE

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

EXAMPLE

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

SEE ALSO

157       Documentation for the Net::XMPP module
158
159       The jabber homepage: <http://www.jabber.org/>
160
161       The sendxmpp homepage: <http://sendxmpp.hostname.sk>
162

AUTHOR

164       sendxmpp has been written by Dirk-Jan C. Binnema
165       <djcb@djcbsoftware.nl>, and uses the Net::XMPP modules written by Ryan
166       Eatmon. Current maintainer is Lubomir Host <lubomir.host@gmail.com>,
167       <http://blog.hostname.sk>
168
169
170
171perl v5.36.0                      2023-01-21                       SENDXMPP(1)
Impressum