TclXMPP

Check-in [b65104f112]
Login

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
SHA1:b65104f112e021fe8e0dc28870633f6fedfbb1db
Date: 2015-06-01 15:37:27
User: sgolovan
Comment:Added a short manual page for the jsend command line client example.
Tags And Properties
Context
2015-06-01
19:36
[bdec1069ef] Allow one to rename the jsend.tcl to jsend when installing the examples. (user: sgolovan, tags: trunk)
15:37
[b65104f112] Added a short manual page for the jsend command line client example. (user: sgolovan, tags: trunk)
2015-05-11
05:41
[4cc480ab1b] Removed tabulation characters and trailing whitespaces. (user: sgolovan, tags: trunk)
Changes
Hide Diffs Unified Diffs Ignore Whitespace Patch

Changes to ChangeLog.






1
2
3
4
5
6
7





2015-05-11  Sergei Golovan  <sgolovan@nes.ru>

	* xmpp/blocking.tcl, xmpp/bosh.tcl, xmpp/muc.tcl, xmpp/ping.tcl,
	  xmpp/poll.tcl: Removed tabulation characters and trailing
	  whitespaces.

2015-04-16  Sergei Golovan  <sgolovan@nes.ru>
>
>
>
>
>







1
2
3
4
5
6
7
8
9
10
11
12
2015-06-01  Sergei Golovan  <sgolovan@nes.ru>

	* examples/jsend.man: Added a short manual page for the jsend
	  command line client example.

2015-05-11  Sergei Golovan  <sgolovan@nes.ru>

	* xmpp/blocking.tcl, xmpp/bosh.tcl, xmpp/muc.tcl, xmpp/ping.tcl,
	  xmpp/poll.tcl: Removed tabulation characters and trailing
	  whitespaces.

2015-04-16  Sergei Golovan  <sgolovan@nes.ru>

Added examples/jsend.man.









































































































































































































































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
[comment {-*- tcl -*- doctools manpage}]
[manpage_begin jsend 1 0.1]
[copyright {2015 Sergei Golovan <sgolovan@nes.ru>}]
[moddesc {Tcl XMPP library}]
[titledesc {Tcl XMPP command line send utility}]
[description]
[para]

This utility is a part of the Tcl XMPP library. It implements a command
line client which can send a single or multiple messages via XMPP
network. To do that it connects to an XMPP server using specified
login and password.

[list_begin definitions]
[call [cmd jsend] [arg recipient] \
        [opt "[option -option] [arg value] ..."]]

[para]

The required Tcl packages for the [cmd jsend] utility are [arg tls]
and quite a few modules from the [arg Tcllib] collection.

[para]

The client takes one mandatory argument [arg recipient] and a few option-value
pairs. The [arg recipient] can be either a JID ot send the messages or
literal "[const -]" in which case the messages will be sent to all roster
members of the connected JID.

[para]

The message body to send can be specified in three ways. First it can be a value
of "[option -body]" option. Second, if "[option -follow]" is specified, it points
to a file which contents will be sent line by line, and after that any apended
line will be sent also. And finally, if there's no "[option -body]"
or "[option -follow]" options then the message is taken from the standard input.

[para]

The full list of the command line options follows below:

[list_begin definitions]
[def "[option -from] [arg jid]"]
[para]
The sender JID. If there's no [option -host] option then the server part
of the specified JID is used to connect to.

[def "[option -password] [arg string]"]
[para]
The sender password.

[def "[option -type] [arg normal|chat]"]
[para]
The message type. Must be one of [const normal] or [const chat].
Defaults to [const chat].

[def "[option -subject] [arg string]"]
[para]
The message subject.

[def "[option -body] [arg string]"]
[para]
The message body.

[def "[option -xhtml] [arg string]"]
[para]
The XHTML message (see XEP-0071 for details).

[def "[option -url] [arg string]"]
[para]
The URL to attach (see XEP-0066 for details).

[def "[option -description] [arg string]"]
[para]
The description for the URL attached (see XEP-0066 for details).

[def "[option -follow] [arg file]"]
[para]
Follow the specified file for the messages stream.

[def "[option -pidfile] [arg file]"]
[para]
Create the specified file with the PID of the running process. This
option is useful together with [option -follow] option.

[def "[option -host] [arg hostname]"]
[para]
Explicit hostname to connect to.

[def "[option -port] [arg number]"]
[para]
Explicit port to connect to.

[def "[option -bosh] [arg string]"]
[para]
BOSH URL (see XEP-0124 and XEP-0206 for details).

[def "[option -tls] [arg boolean]"]
[para]
Whether the old legacy SSL encryption is to be used (defaults to [const false]).

[def "[option -starttls] [arg boolean]"]
[para]
Whether the STARTTLS and therefore the TLS encryption is to be used (defaults
to [const true]).

[def "[option -sasl] [arg boolean]"]
[para]
Whether the SASL authentication is to be used (defaults to [const true]).

[list_end]
[list_end]

[section "FILES"]

The file .jsendrc.tcl in the current directory or in the current user's home
directory is sourced if it's available and is not world readable. It can contain
any Tcl code and modify the jsend behavior in any way but its primary goal is to
define [var args] list of option-value pairs, e.g.

[example {
set args {-from fred@example.com/bedrock -password wilma}
}]

[section "AUTHORS"]

Marshall T. Rose,
Sergei Golovan

[keywords Tcl XMPP]
[comment { vim: set ft=tcl ts=8 sw=4 sts=4 et: }]
[manpage_end]