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
|
.\" '\"
.\" '\" Ivy jrpobe, an Ivy agent for monitoring exchanges on a bus
.\" '\"
.\" '\" Copyright (C) 1997-2006
.\" '\" DSNA/DTI/SDER ( Centre d'Études de la Navigation Aérienne )
.\" '\"
.\" '\" See the file "license.terms" for information on usage and redistribution
.\" '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
.\" '\"
.\" '\"
.TH "jprobe" "" "" "Yannick Jestin <Yannick.Jestin@enac.fr>" ""
.SH "NAME"
jprobe \- a Ivy java agent for monitoring exchanges on a bus
.SH "SYNOPSIS"
jprobe [-b bus] [regexps]
.SH OPTIONS
-b BUS specifies the Ivy bus domain
-c CLASS uses a message class CLASS=Word1,Word2,Word3...
-n ivyname (default JPROBE)
-q quiet, no tty output
-d debug
-t time stamp each message
-s sends to self
-h help
regexp is a list of zero to many Perl5 compatible regular expression jprobe
will subscribe to every of those regular expressions, and print the contents
(or more exactly the captured contents) of all matching messages that will be
emitted on the bus by other applications. Do not forget to protect your
regexps with quotes if you use brackets or the * sign, otherwise your shell
might interpret them.
.SH "DESCRIPTION"
jprobe connects to an Ivy bus and allows you to send and receive messages through a text interface. This is mainly useful for testing and debugging Ivy applications.
.SH EXAMPLES
.B jprobe '(.*)'
will print all messages exchanged on the default bus, with their full contents.
.SH LINE COMMANDS
once jprobe is started, you can send messages line by line. If you want to
issue a command to jprobe, use one of the following commands:
.nf
\.die CLIENT sends a die message
.nf
\.dieall-yes-i-am-sure sends a die to all clients
.nf
\.direct CLIENT ID MSG sends the direct message to the client
.nf
\.bye quits the probe
.nf
\.quit quites the probe
.nf
\.list lists the clients on the bus
.nf
\.bind REGEXP subscribes to a regexp
.nf
\.unbind REGEXP unsubscribes to a regexp
.nf
\.bound CLIENT lists the subscriptions of a client, .bound to get all
.nf
\.bound lists the subscriptions
.nf
\.where CLIENT displays the host where a client runs
.nf
\.time COUNT MESSAGE measures the time it takes to send COUNT messages
.nf
\.ping CLIENT measures the roundrip time in milliseconds to a client
.SH "EXAMPLES"
.nf
jprobe \-help
.nf
jprobe \-b 127.0.0.1:3042,10.192.36:2021,228.5.6.7:54321 '^coucou (.*)'
.nf
jprobe \-d \-b 10.192.36:2021 '^coucou (.*)'
.SH "BUGS"
See the /usr/share/doc/libivy-java/BUGS file for details.
.SH "AUTHORS"
.nf
Yannick Jestin <Yannick.Jestin@enac.fr>
.nf
Francois\-Regis Colin <fcolin@cena.fr>
.SH "SEE ALSO"
ivy\-c (1)
.nf
ivy\-perl (1)
.nf
ivy\-c\-functions (1)
.nf
ivyprobe (1)
.nf
pcrepattern (3)
.sp
For further details, please refer to the Ivy html page at http://www.tls.cena.fr/products/ivy/
.SH "NOTES"
In case of any comment or bug report on this library, please contact yannick.jestin@enac.fr
.nf
Special thanks to Michelle Jacomi for her kind support and
documentation writing.
|
