Import Debian changes 1.24-1
[cascardo/sendxmpp.git] / debian / README.Debian
1 sendxmpp for Debian
2 -------------------
3
4 Since 2.14 version, sendxmpp is using a new config file format. The file name
5 must be ~/.sendxmpprc with 400 permission. See below an example of the new
6 format:
7
8   username: john
9   jserver: jabber.example.com
10   port: 5222
11   password: my-very-nice-pass2
12
13 There are some tips for sendxmpp 2.14, when using cryptography (I believe these
14 tips will work for 2.13 version too). The following topics will require a
15 special attention.
16
17 1. When using sendxmpp, I get:
18
19   "Could not connect to 'jabber.example.com' on port 5222: The server requires
20    us to use TLS, but you did not specify that TLS was an option."
21
22   To solve this problem, use -t option.
23
24 2. When sending a message, the following error is shown:
25
26   "Invalid or unreadable path specified for ssl_ca_path. at
27    /usr/share/perl5/XML/Stream.pm line 641."
28
29   Use '-a /etc/ssl/certs/' or '--tls-ca-path /etc/ssl/certs' option.
30
31 3. I am getting several messages, similar to lines shown below:
32
33   "Use of uninitialized value $sid in hash element at /usr/share/perl5/XML/Stream.pm line 1829.
34    Use of uninitialized value $sid in concatenation (.) or string at /usr/share/perl5/XML/Stream.pm line 2740.
35    Use of uninitialized value $sid in hash element at /usr/share/perl5/XML/Stream.pm line 2742.
36    Use of uninitialized value $sid in concatenation (.) or string at /usr/share/perl5/XML/Stream.pm line 1668.
37    Use of uninitialized value $sid in hash element at /usr/share/perl5/XML/Stream.pm line 1669.
38    Use of uninitialized value in concatenation (.) or string at /usr/share/perl5/XML/Stream.pm line 1669.
39    Use of uninitialized value $sid in hash element at /usr/share/perl5/XML/Stream.pm line 1671.
40    Use of uninitialized value $sid in hash element at /usr/share/perl5/XML/Stream.pm line 1673.
41    Use of uninitialized value in numeric eq (==) at /usr/share/perl5/XML/Stream.pm line 1673.
42    Use of uninitialized value $sid in hash element at /usr/share/perl5/XML/Stream.pm line 1675.
43    Use of uninitialized value $sid in hash element at /usr/share/perl5/XML/Stream.pm line 1678.
44    Use of uninitialized value $sid in hash element at /usr/share/perl5/XML/Stream.pm line 2620.
45    Use of uninitialized value $sid in concatenation (.) or string at /usr/share/perl5/XML/Stream.pm line 2740.
46    Use of uninitialized value $sid in hash element at /usr/share/perl5/XML/Stream.pm line 2742.
47    Use of uninitialized value in concatenation (.) or string at /usr/share/perl5/XML/Stream.pm line 1440.
48    Use of uninitialized value in numeric eq (==) at /usr/share/perl5/XML/Stream.pm line 1443.
49    Use of uninitialized value within %status in numeric eq (==) at /usr/share/perl5/XML/Stream.pm line 1506.
50    Use of uninitialized value in subtraction (-) at /usr/share/perl5/XML/Stream.pm line 1507.
51    Use of uninitialized value in concatenation (.) or string at /usr/share/perl5/XML/Stream.pm line 1669.
52    Use of uninitialized value in numeric eq (==) at /usr/share/perl5/XML/Stream.pm line 1673.
53    Use of uninitialized value in hash element at /usr/share/perl5/Net/XMPP/Connection.pm line 433.
54    Use of uninitialized value in hash element at /usr/share/perl5/Net/XMPP/Connection.pm line 440.
55    Use of uninitialized value in hash element at /usr/share/perl5/Net/XMPP/Connection.pm line 433.
56    Use of uninitialized value in string eq at /usr/bin/sendxmpp line 515.
57    Error 'AuthSend': [?]
58    Use of uninitialized value $sid in concatenation (.) or string at /usr/share/perl5/XML/Stream.pm line 1668.
59    Use of uninitialized value $sid in hash element at /usr/share/perl5/XML/Stream.pm line 1669.
60    Use of uninitialized value $sid in hash element at /usr/share/perl5/XML/Stream.pm line 1671.
61    Use of uninitialized value $sid in hash element at /usr/share/perl5/XML/Stream.pm line 1673.
62    Use of uninitialized value $sid in hash element at /usr/share/perl5/XML/Stream.pm line 1266.
63    Use of uninitialized value in string eq at /usr/share/perl5/XML/Stream.pm line 1266.
64    Use of uninitialized value $sid in hash element at /usr/share/perl5/XML/Stream.pm line 1266.
65    Use of uninitialized value in string eq at /usr/share/perl5/XML/Stream.pm line 1266.
66    Use of uninitialized value $sid in hash element at /usr/share/perl5/XML/Stream.pm line 1267.
67    Use of uninitialized value in delete at /usr/share/perl5/XML/Stream.pm line 1267.
68    Use of uninitialized value $sid in hash element at /usr/share/perl5/XML/Stream.pm line 1268.
69    Use of uninitialized value $sid in hash element at /usr/share/perl5/XML/Stream.pm line 1270.
70    Use of uninitialized value $sid in hash element at /usr/share/perl5/XML/Stream.pm line 1270.
71    Use of uninitialized value $sid in hash element at /usr/share/perl5/XML/Stream.pm line 1270.
72    Use of uninitialized value $sid in hash element at /usr/share/perl5/XML/Stream.pm line 1270.
73    Use of uninitialized value $sid in hash element at /usr/share/perl5/XML/Stream.pm line 1270.
74    Use of uninitialized value $sid in delete at /usr/share/perl5/XML/Stream.pm line 1272."
75
76   To solve:
77
78   # apt-get install ca-certificates
79   ---> Copy the root certificate from your CA to /usr/local/share/ca-certificates/.
80        The file must use te suffix .crt, e.g. mycert.crt
81   # update-ca-certificates
82   ---> For more details: $ man update-ca-certificates
83
84 4. I am seeing an unknown behaviour.
85
86   Add the '-v' option to your command line to try debug and find the problem.
87
88  -- Joao Eriberto Mota Filho <eriberto@debian.org>  Tue, 18 Jul 2017 10:38:30 -0300