From thom@telcom.io Thu May 26 19:05:52 2016
From: Thom Seddon <thom@telcom.io>
To: sr-users@lists.kamailio.org
Subject: [SR-Users] Multiple async operations in single transaction fail
	(using http_async_client)
Date: Thu, 26 May 2016 18:05:26 +0100
Message-ID:
 <CAAXCLupeJbEHZ=fPBwQmurEn9cM2suYXQ4xyKo9vQC3O-xfE-Q@mail.gmail.com>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="===============0427712302=="

--===============0427712302==
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: quoted-printable

Hi All,

I've been doing some work this week with the new http_async_client module,
it seems that with it's default behaviour it's not possible to execute
another async query in the block immediately following the response, for
example the following config:

request_route {
  if (!t_newtran()) {
      sl_reply_error();
      exit();
  }
  http_async_query("http://localhost:8090/req_1", '{"user":"$fU"}',
"REQ_1");
}

route[REQ_1] {
  xlog("L_INFO", "route[REQ_1]: INIT\n");
  if ($http_ok) {
    xlog("L_INFO", "route[REQ_1]: status $http_rs\n");
    xlog("L_INFO", "route[REQ_1]: Sending REQ_2\n");
    http_async_query("http://localhost:8090/req_2", '{"user":"$fU"}',
"REQ_2");
  } else {
    xlog("L_INFO", "route[REQ_1]: error  $http_err)\n");
  }
}

route[REQ_2] {
  xlog("L_INFO", "route[REQ_2]: INIT\n");
  if ($http_ok) {
    xlog("L_INFO", "route[REQ_2]: status $http_rs\n");
  } else {
    xlog("L_INFO", "route[REQ_2]: error  $http_err)\n");
  }
}

Generates the following error:

10(11832) INFO: <script>: route[REQ_1]: INIT
10(11832) INFO: <script>: route[REQ_1]: status 200
10(11832) INFO: <script>: route[REQ_1]: Sending REQ_2
10(11832) WARNING: tm [t_suspend.c:186]: t_continue(): transaction is not
suspended [53195:560306836]

Looking at the source, http_async_client calls t_suspend, then goes away
and performs the request in the background. On response it calls t_continue
and then this block
<https://github.com/kamailio/kamailio/blob/4.4/modules/tm/t_suspend.c#L270-L2=
75>
in t_continue will continue execution, the second query will cause
http_async_client to call t_suspend whilst sill executing from
the previous t_continue. Once they query is sent, the first t_continue will
complete, removing the T_ASYNC_SUSPENDED flag. When the second query
returns it doesn't find the flag and so fails as shown.

I'm far from an expect on this so would really appreciate some pointers, it
seems to fundamental to be a race condition in tm but the usage in
http_async_client seems to match usage in other modules so I'm not sure on
the best tactic.
I've tried peppering append_branch and async_route call's in various places
to no avail.

Full debug log here: http://pastebin.com/raw/rFmm0fmf

Any help appreciated,

*Thom Seddon*



--===============0427712302==
Content-Type: text/html
Content-Transfer-Encoding: base64
Content-Disposition: attachment; filename="attachment.html"
MIME-Version: 1.0

PGRpdiBkaXI9Imx0ciI+SGkgQWxsLDxkaXY+PGJyPjwvZGl2PjxkaXY+SSYjMzk7dmUgYmVlbiBk
b2luZyBzb21lIHdvcmsgdGhpcyB3ZWVrIHdpdGggdGhlIG5ldyBodHRwX2FzeW5jX2NsaWVudCBt
b2R1bGUsIGl0IHNlZW1zIHRoYXQgd2l0aCBpdCYjMzk7cyBkZWZhdWx0IGJlaGF2aW91ciBpdCYj
Mzk7cyBub3QgcG9zc2libGUgdG8gZXhlY3V0ZSBhbm90aGVyIGFzeW5jIHF1ZXJ5IGluIHRoZSBi
bG9jayBpbW1lZGlhdGVseSBmb2xsb3dpbmcgdGhlIHJlc3BvbnNlLCBmb3IgZXhhbXBsZSB0aGUg
Zm9sbG93aW5nIGNvbmZpZzo8YnI+PGJyPjxkaXY+PGZvbnQgZmFjZT0ibW9ub3NwYWNlLCBtb25v
c3BhY2UiPnJlcXVlc3Rfcm91dGUgezwvZm9udD48L2Rpdj48ZGl2Pjxmb250IGZhY2U9Im1vbm9z
cGFjZSwgbW9ub3NwYWNlIj7CoCBpZiAoIXRfbmV3dHJhbigpKSB7PC9mb250PjwvZGl2PjxkaXY+
PGZvbnQgZmFjZT0ibW9ub3NwYWNlLCBtb25vc3BhY2UiPsKgIMKgIMKgIHNsX3JlcGx5X2Vycm9y
KCk7PC9mb250PjwvZGl2PjxkaXY+PGZvbnQgZmFjZT0ibW9ub3NwYWNlLCBtb25vc3BhY2UiPsKg
IMKgIMKgIGV4aXQoKTs8L2ZvbnQ+PC9kaXY+PGRpdj48Zm9udCBmYWNlPSJtb25vc3BhY2UsIG1v
bm9zcGFjZSI+wqAgfTwvZm9udD48L2Rpdj48ZGl2Pjxmb250IGZhY2U9Im1vbm9zcGFjZSwgbW9u
b3NwYWNlIj7CoCBodHRwX2FzeW5jX3F1ZXJ5KCZxdW90OzxhIGhyZWY9Imh0dHA6Ly9sb2NhbGhv
c3Q6ODA5MC9yZXFfMSI+aHR0cDovL2xvY2FsaG9zdDo4MDkwL3JlcV8xPC9hPiZxdW90OywgJiMz
OTt7JnF1b3Q7dXNlciZxdW90OzomcXVvdDskZlUmcXVvdDt9JiMzOTssICZxdW90O1JFUV8xJnF1
b3Q7KTs8L2ZvbnQ+PC9kaXY+PGRpdj48Zm9udCBmYWNlPSJtb25vc3BhY2UsIG1vbm9zcGFjZSI+
fTwvZm9udD48L2Rpdj48ZGl2Pjxmb250IGZhY2U9Im1vbm9zcGFjZSwgbW9ub3NwYWNlIj48YnI+
PC9mb250PjwvZGl2PjxkaXY+PGZvbnQgZmFjZT0ibW9ub3NwYWNlLCBtb25vc3BhY2UiPnJvdXRl
W1JFUV8xXSB7PC9mb250PjwvZGl2PjxkaXY+PGZvbnQgZmFjZT0ibW9ub3NwYWNlLCBtb25vc3Bh
Y2UiPsKgIHhsb2coJnF1b3Q7TF9JTkZPJnF1b3Q7LCAmcXVvdDtyb3V0ZVtSRVFfMV06IElOSVRc
biZxdW90Oyk7PC9mb250PjwvZGl2PjxkaXY+PGZvbnQgZmFjZT0ibW9ub3NwYWNlLCBtb25vc3Bh
Y2UiPsKgIGlmICgkaHR0cF9vaykgezwvZm9udD48L2Rpdj48ZGl2Pjxmb250IGZhY2U9Im1vbm9z
cGFjZSwgbW9ub3NwYWNlIj7CoCDCoCB4bG9nKCZxdW90O0xfSU5GTyZxdW90OywgJnF1b3Q7cm91
dGVbUkVRXzFdOiBzdGF0dXMgJGh0dHBfcnNcbiZxdW90Oyk7PC9mb250PjwvZGl2PjxkaXY+PGZv
bnQgZmFjZT0ibW9ub3NwYWNlLCBtb25vc3BhY2UiPsKgIMKgIHhsb2coJnF1b3Q7TF9JTkZPJnF1
b3Q7LCAmcXVvdDtyb3V0ZVtSRVFfMV06IFNlbmRpbmcgUkVRXzJcbiZxdW90Oyk7PC9mb250Pjwv
ZGl2PjxkaXY+PGZvbnQgZmFjZT0ibW9ub3NwYWNlLCBtb25vc3BhY2UiPsKgIMKgIGh0dHBfYXN5
bmNfcXVlcnkoJnF1b3Q7PGEgaHJlZj0iaHR0cDovL2xvY2FsaG9zdDo4MDkwL3JlcV8yIj5odHRw
Oi8vbG9jYWxob3N0OjgwOTAvcmVxXzI8L2E+JnF1b3Q7LCAmIzM5O3smcXVvdDt1c2VyJnF1b3Q7
OiZxdW90OyRmVSZxdW90O30mIzM5OywgJnF1b3Q7UkVRXzImcXVvdDspOzwvZm9udD48L2Rpdj48
ZGl2Pjxmb250IGZhY2U9Im1vbm9zcGFjZSwgbW9ub3NwYWNlIj7CoCB9IGVsc2UgezwvZm9udD48
L2Rpdj48ZGl2Pjxmb250IGZhY2U9Im1vbm9zcGFjZSwgbW9ub3NwYWNlIj7CoCDCoCB4bG9nKCZx
dW90O0xfSU5GTyZxdW90OywgJnF1b3Q7cm91dGVbUkVRXzFdOiBlcnJvciDCoCRodHRwX2Vycilc
biZxdW90Oyk7PC9mb250PjwvZGl2PjxkaXY+PGZvbnQgZmFjZT0ibW9ub3NwYWNlLCBtb25vc3Bh
Y2UiPsKgIH08L2ZvbnQ+PC9kaXY+PGRpdj48Zm9udCBmYWNlPSJtb25vc3BhY2UsIG1vbm9zcGFj
ZSI+fTwvZm9udD48L2Rpdj48ZGl2Pjxmb250IGZhY2U9Im1vbm9zcGFjZSwgbW9ub3NwYWNlIj48
YnI+PC9mb250PjwvZGl2PjxkaXY+PGZvbnQgZmFjZT0ibW9ub3NwYWNlLCBtb25vc3BhY2UiPnJv
dXRlW1JFUV8yXSB7PC9mb250PjwvZGl2PjxkaXY+PGZvbnQgZmFjZT0ibW9ub3NwYWNlLCBtb25v
c3BhY2UiPsKgIHhsb2coJnF1b3Q7TF9JTkZPJnF1b3Q7LCAmcXVvdDtyb3V0ZVtSRVFfMl06IElO
SVRcbiZxdW90Oyk7PC9mb250PjwvZGl2PjxkaXY+PGZvbnQgZmFjZT0ibW9ub3NwYWNlLCBtb25v
c3BhY2UiPsKgIGlmICgkaHR0cF9vaykgezwvZm9udD48L2Rpdj48ZGl2Pjxmb250IGZhY2U9Im1v
bm9zcGFjZSwgbW9ub3NwYWNlIj7CoCDCoCB4bG9nKCZxdW90O0xfSU5GTyZxdW90OywgJnF1b3Q7
cm91dGVbUkVRXzJdOiBzdGF0dXMgJGh0dHBfcnNcbiZxdW90Oyk7PC9mb250PjwvZGl2PjxkaXY+
PGZvbnQgZmFjZT0ibW9ub3NwYWNlLCBtb25vc3BhY2UiPsKgIH0gZWxzZSB7PC9mb250PjwvZGl2
PjxkaXY+PGZvbnQgZmFjZT0ibW9ub3NwYWNlLCBtb25vc3BhY2UiPsKgIMKgIHhsb2coJnF1b3Q7
TF9JTkZPJnF1b3Q7LCAmcXVvdDtyb3V0ZVtSRVFfMl06IGVycm9yIMKgJGh0dHBfZXJyKVxuJnF1
b3Q7KTs8L2ZvbnQ+PC9kaXY+PGRpdj48Zm9udCBmYWNlPSJtb25vc3BhY2UsIG1vbm9zcGFjZSI+
wqAgfTwvZm9udD48L2Rpdj48ZGl2Pjxmb250IGZhY2U9Im1vbm9zcGFjZSwgbW9ub3NwYWNlIj59
PC9mb250PjwvZGl2PjxkaXY+PGZvbnQgZmFjZT0ibW9ub3NwYWNlLCBtb25vc3BhY2UiPjxicj48
L2ZvbnQ+PC9kaXY+PGRpdj48Zm9udCBmYWNlPSJhcmlhbCwgaGVsdmV0aWNhLCBzYW5zLXNlcmlm
Ij5HZW5lcmF0ZXMgdGhlIGZvbGxvd2luZyBlcnJvcjo8L2ZvbnQ+PC9kaXY+PGRpdj48Zm9udCBm
YWNlPSJtb25vc3BhY2UsIG1vbm9zcGFjZSI+PGJyPjwvZm9udD48L2Rpdj48ZGl2PjxkaXYgc3R5
bGU9ImZvbnQtZmFtaWx5Om1vbm9zcGFjZSxtb25vc3BhY2UiPjEwKDExODMyKSBJTkZPOiAmbHQ7
c2NyaXB0Jmd0Ozogcm91dGVbUkVRXzFdOiBJTklUPC9kaXY+PGRpdiBzdHlsZT0iZm9udC1mYW1p
bHk6bW9ub3NwYWNlLG1vbm9zcGFjZSI+MTAoMTE4MzIpIElORk86ICZsdDtzY3JpcHQmZ3Q7OiBy
b3V0ZVtSRVFfMV06IHN0YXR1cyAyMDA8L2Rpdj48ZGl2IHN0eWxlPSJmb250LWZhbWlseTptb25v
c3BhY2UsbW9ub3NwYWNlIj4xMCgxMTgzMikgSU5GTzogJmx0O3NjcmlwdCZndDs6IHJvdXRlW1JF
UV8xXTogU2VuZGluZyBSRVFfMjwvZGl2PjxkaXYgc3R5bGU9ImZvbnQtZmFtaWx5Om1vbm9zcGFj
ZSxtb25vc3BhY2UiPjEwKDExODMyKSBXQVJOSU5HOiB0bSBbdF9zdXNwZW5kLmM6MTg2XTogdF9j
b250aW51ZSgpOiB0cmFuc2FjdGlvbiBpcyBub3Qgc3VzcGVuZGVkIFs1MzE5NTo1NjAzMDY4MzZd
PC9kaXY+PGRpdiBzdHlsZT0iZm9udC1mYW1pbHk6bW9ub3NwYWNlLG1vbm9zcGFjZSI+PGJyPjwv
ZGl2PjwvZGl2PjxkaXY+PGZvbnQgZmFjZT0iYXJpYWwsIGhlbHZldGljYSwgc2Fucy1zZXJpZiI+
TG9va2luZyBhdCB0aGUgc291cmNlLCBodHRwX2FzeW5jX2NsaWVudCBjYWxscyB0X3N1c3BlbmQs
IHRoZW4gZ29lcyBhd2F5IGFuZCBwZXJmb3JtcyB0aGUgcmVxdWVzdCBpbiB0aGUgYmFja2dyb3Vu
ZC4gT24gcmVzcG9uc2UgaXQgY2FsbHMgdF9jb250aW51ZSBhbmQgdGhlbsKgPGEgaHJlZj0iaHR0
cHM6Ly9naXRodWIuY29tL2thbWFpbGlvL2thbWFpbGlvL2Jsb2IvNC40L21vZHVsZXMvdG0vdF9z
dXNwZW5kLmMjTDI3MC1MMjc1Ij50aGlzIGJsb2NrPC9hPiBpbiB0X2NvbnRpbnVlIHdpbGwgY29u
dGludWUgZXhlY3V0aW9uLCB0aGUgc2Vjb25kIHF1ZXJ5IHdpbGwgY2F1c2UgaHR0cF9hc3luY19j
bGllbnQgdG8gY2FsbCB0X3N1c3BlbmQgd2hpbHN0IHNpbGwgZXhlY3V0aW5nIGZyb20gdGhlwqBw
cmV2aW91c8KgdF9jb250aW51ZS7CoE9uY2UgdGhleSBxdWVyeSBpcyBzZW50LCB0aGUgZmlyc3Qg
dF9jb250aW51ZSB3aWxsIGNvbXBsZXRlLCByZW1vdmluZyB0aGUgVF9BU1lOQ19TVVNQRU5ERUQg
ZmxhZy4gV2hlbiB0aGUgc2Vjb25kIHF1ZXJ5IHJldHVybnMgaXQgZG9lc24mIzM5O3QgZmluZCB0
aGUgZmxhZyBhbmQgc28gZmFpbHMgYXMgc2hvd24uPC9mb250PjwvZGl2PjxkaXY+PGZvbnQgZmFj
ZT0iYXJpYWwsIGhlbHZldGljYSwgc2Fucy1zZXJpZiI+PGJyPjwvZm9udD48L2Rpdj48ZGl2Pjxm
b250IGZhY2U9ImFyaWFsLCBoZWx2ZXRpY2EsIHNhbnMtc2VyaWYiPkkmIzM5O20gZmFyIGZyb20g
YW4gZXhwZWN0IG9uIHRoaXMgc28gd291bGQgcmVhbGx5IGFwcHJlY2lhdGUgc29tZSBwb2ludGVy
cywgaXQgc2VlbXMgdG8gZnVuZGFtZW50YWwgdG8gYmUgYSByYWNlIGNvbmRpdGlvbiBpbiB0bSBi
dXQgdGhlIHVzYWdlIGluIGh0dHBfYXN5bmNfY2xpZW50IHNlZW1zIHRvIG1hdGNoIHVzYWdlIGlu
IG90aGVyIG1vZHVsZXMgc28gSSYjMzk7bSBub3Qgc3VyZSBvbiB0aGUgYmVzdCB0YWN0aWMuPC9m
b250PjwvZGl2PjxkaXY+PGZvbnQgZmFjZT0iYXJpYWwsIGhlbHZldGljYSwgc2Fucy1zZXJpZiI+
SSYjMzk7dmUgdHJpZWQgcGVwcGVyaW5nIGFwcGVuZF9icmFuY2ggYW5kIGFzeW5jX3JvdXRlIGNh
bGwmIzM5O3MgaW4gdmFyaW91cyBwbGFjZXMgdG8gbm8gYXZhaWwuPC9mb250PjwvZGl2PjxkaXY+
PGZvbnQgZmFjZT0iYXJpYWwsIGhlbHZldGljYSwgc2Fucy1zZXJpZiI+PGJyPjwvZm9udD48L2Rp
dj48ZGl2Pjxmb250IGZhY2U9ImFyaWFsLCBoZWx2ZXRpY2EsIHNhbnMtc2VyaWYiPkZ1bGwgZGVi
dWcgbG9nIGhlcmU6wqA8YSBocmVmPSJodHRwOi8vcGFzdGViaW4uY29tL3Jhdy9yRm1tMGZtZiI+
aHR0cDovL3Bhc3RlYmluLmNvbS9yYXcvckZtbTBmbWY8L2E+PC9mb250PjwvZGl2PjxkaXY+PGZv
bnQgZmFjZT0iYXJpYWwsIGhlbHZldGljYSwgc2Fucy1zZXJpZiI+PGJyPjwvZm9udD48L2Rpdj48
ZGl2Pjxmb250IGZhY2U9ImFyaWFsLCBoZWx2ZXRpY2EsIHNhbnMtc2VyaWYiPkFueSBoZWxwIGFw
cHJlY2lhdGVkLDwvZm9udD48L2Rpdj48ZGl2PjxkaXYgY2xhc3M9ImdtYWlsX3NpZ25hdHVyZSI+
PGRpdiBkaXI9Imx0ciI+PGRpdiBkaXI9Imx0ciI+PGRpdiBkaXI9Imx0ciI+PHAgc3R5bGU9ImNv
bG9yOnJnYigxMzYsMTM2LDEzNikiPjxiIHN0eWxlPSJjb2xvcjpyZ2IoMCwwLDApO2ZvbnQtZmFt
aWx5OmFyaWFsLGhlbHZldGljYSxzYW5zLXNlcmlmO2ZvbnQtc2l6ZTpzbWFsbCI+VGhvbSBTZWRk
b248L2I+PC9wPjwvZGl2PjwvZGl2PjwvZGl2PjwvZGl2PjwvZGl2Pgo8L2Rpdj48L2Rpdj4K

--===============0427712302==--


From miconda@gmail.com Mon May 30 10:55:35 2016
From: Daniel-Constantin Mierla <miconda@gmail.com>
To: sr-users@lists.kamailio.org
Subject: Re: [SR-Users] Multiple async operations in single transaction fail
 (using http_async_client)
Date: Mon, 30 May 2016 10:55:26 +0200
Message-ID: <d07ceee2-c3e4-18c4-0573-d920209b0ee9@gmail.com>
In-Reply-To:
 <CAAXCLupeJbEHZ=fPBwQmurEn9cM2suYXQ4xyKo9vQC3O-xfE-Q@mail.gmail.com>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="===============1000275983=="

--===============1000275983==
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: quoted-printable

Hello,

I saw you opened an issue on github on this topic -- let's continue
there the discussion.

Cheers,
Daniel


On 26/05/16 19:05, Thom Seddon wrote:
> Hi All,
>
> I've been doing some work this week with the new http_async_client
> module, it seems that with it's default behaviour it's not possible to
> execute another async query in the block immediately following the
> response, for example the following config:
>
> request_route {
>   if (!t_newtran()) {
>       sl_reply_error();
>       exit();
>   }
>   http_async_query("http://localhost:8090/req_1", '{"user":"$fU"}',
> "REQ_1");
> }
>
> route[REQ_1] {
>   xlog("L_INFO", "route[REQ_1]: INIT\n");
>   if ($http_ok) {
>     xlog("L_INFO", "route[REQ_1]: status $http_rs\n");
>     xlog("L_INFO", "route[REQ_1]: Sending REQ_2\n");
>     http_async_query("http://localhost:8090/req_2", '{"user":"$fU"}',
> "REQ_2");
>   } else {
>     xlog("L_INFO", "route[REQ_1]: error  $http_err)\n");
>   }
> }
>
> route[REQ_2] {
>   xlog("L_INFO", "route[REQ_2]: INIT\n");
>   if ($http_ok) {
>     xlog("L_INFO", "route[REQ_2]: status $http_rs\n");
>   } else {
>     xlog("L_INFO", "route[REQ_2]: error  $http_err)\n");
>   }
> }
>
> Generates the following error:
>
> 10(11832) INFO: <script>: route[REQ_1]: INIT
> 10(11832) INFO: <script>: route[REQ_1]: status 200
> 10(11832) INFO: <script>: route[REQ_1]: Sending REQ_2
> 10(11832) WARNING: tm [t_suspend.c:186]: t_continue(): transaction is
> not suspended [53195:560306836]
>
> Looking at the source, http_async_client calls t_suspend, then goes
> away and performs the request in the background. On response it calls
> t_continue and then this block
> <https://github.com/kamailio/kamailio/blob/4.4/modules/tm/t_suspend.c#L270-=
L275>
> in t_continue will continue execution, the second query will cause
> http_async_client to call t_suspend whilst sill executing from
> the previous t_continue. Once they query is sent, the first t_continue
> will complete, removing the T_ASYNC_SUSPENDED flag. When the second
> query returns it doesn't find the flag and so fails as shown.
>
> I'm far from an expect on this so would really appreciate some
> pointers, it seems to fundamental to be a race condition in tm but the
> usage in http_async_client seems to match usage in other modules so
> I'm not sure on the best tactic.
> I've tried peppering append_branch and async_route call's in various
> places to no avail.
>
> Full debug log here: http://pastebin.com/raw/rFmm0fmf
>
> Any help appreciated,
>
> *Thom Seddon*
>
>
>
> _______________________________________________
> SIP Express Router (SER) and Kamailio (OpenSER) - sr-users mailing list
> sr-users(a)lists.sip-router.org
> http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-users

--=20
Daniel-Constantin Mierla
http://www.asipto.com - http://www.kamailio.org
http://twitter.com/#!/miconda - http://www.linkedin.com/in/miconda




--===============1000275983==
Content-Type: text/html
Content-Transfer-Encoding: base64
Content-Disposition: attachment; filename="attachment.html"
MIME-Version: 1.0

PGh0bWw+CiAgPGhlYWQ+CiAgICA8bWV0YSBjb250ZW50PSJ0ZXh0L2h0bWw7IGNoYXJzZXQ9d2lu
ZG93cy0xMjUyIgogICAgICBodHRwLWVxdWl2PSJDb250ZW50LVR5cGUiPgogIDwvaGVhZD4KICA8
Ym9keSBiZ2NvbG9yPSIjRkZGRkZGIiB0ZXh0PSIjMDAwMDAwIj4KICAgIDxwPkhlbGxvLDwvcD4K
ICAgIDxwPkkgc2F3IHlvdSBvcGVuZWQgYW4gaXNzdWUgb24gZ2l0aHViIG9uIHRoaXMgdG9waWMg
LS0gbGV0J3MKICAgICAgY29udGludWUgdGhlcmUgdGhlIGRpc2N1c3Npb24uPC9wPgogICAgPHA+
Q2hlZXJzLDxicj4KICAgICAgRGFuaWVsPGJyPgogICAgPC9wPgogICAgPGJyPgogICAgPGRpdiBj
bGFzcz0ibW96LWNpdGUtcHJlZml4Ij5PbiAyNi8wNS8xNiAxOTowNSwgVGhvbSBTZWRkb24gd3Jv
dGU6PGJyPgogICAgPC9kaXY+CiAgICA8YmxvY2txdW90ZQpjaXRlPSJtaWQ6Q0FBWENMdXBlSmJF
SFo9ZlBCd1FtdXJFbjljTTJzdVlYUTR4eUtvOXZRQzNPLXhmRS1RQG1haWwuZ21haWwuY29tIgog
ICAgICB0eXBlPSJjaXRlIj4KICAgICAgPGRpdiBkaXI9Imx0ciI+SGkgQWxsLAogICAgICAgIDxk
aXY+PGJyPgogICAgICAgIDwvZGl2PgogICAgICAgIDxkaXY+SSd2ZSBiZWVuIGRvaW5nIHNvbWUg
d29yayB0aGlzIHdlZWsgd2l0aCB0aGUgbmV3CiAgICAgICAgICBodHRwX2FzeW5jX2NsaWVudCBt
b2R1bGUsIGl0IHNlZW1zIHRoYXQgd2l0aCBpdCdzIGRlZmF1bHQKICAgICAgICAgIGJlaGF2aW91
ciBpdCdzIG5vdCBwb3NzaWJsZSB0byBleGVjdXRlIGFub3RoZXIgYXN5bmMgcXVlcnkgaW4KICAg
ICAgICAgIHRoZSBibG9jayBpbW1lZGlhdGVseSBmb2xsb3dpbmcgdGhlIHJlc3BvbnNlLCBmb3Ig
ZXhhbXBsZSB0aGUKICAgICAgICAgIGZvbGxvd2luZyBjb25maWc6PGJyPgogICAgICAgICAgPGJy
PgogICAgICAgICAgPGRpdj48Zm9udCBmYWNlPSJtb25vc3BhY2UsIG1vbm9zcGFjZSI+cmVxdWVz
dF9yb3V0ZSB7PC9mb250PjwvZGl2PgogICAgICAgICAgPGRpdj48Zm9udCBmYWNlPSJtb25vc3Bh
Y2UsIG1vbm9zcGFjZSI+oCBpZiAoIXRfbmV3dHJhbigpKSB7PC9mb250PjwvZGl2PgogICAgICAg
ICAgPGRpdj48Zm9udCBmYWNlPSJtb25vc3BhY2UsIG1vbm9zcGFjZSI+oCCgIKAgc2xfcmVwbHlf
ZXJyb3IoKTs8L2ZvbnQ+PC9kaXY+CiAgICAgICAgICA8ZGl2Pjxmb250IGZhY2U9Im1vbm9zcGFj
ZSwgbW9ub3NwYWNlIj6gIKAgoCBleGl0KCk7PC9mb250PjwvZGl2PgogICAgICAgICAgPGRpdj48
Zm9udCBmYWNlPSJtb25vc3BhY2UsIG1vbm9zcGFjZSI+oCB9PC9mb250PjwvZGl2PgogICAgICAg
ICAgPGRpdj48Zm9udCBmYWNlPSJtb25vc3BhY2UsIG1vbm9zcGFjZSI+oCBodHRwX2FzeW5jX3F1
ZXJ5KCI8YQogICAgICAgICAgICAgICAgbW96LWRvLW5vdC1zZW5kPSJ0cnVlIgogICAgICAgICAg
ICAgICAgaHJlZj0iaHR0cDovL2xvY2FsaG9zdDo4MDkwL3JlcV8xIj48YSBjbGFzcz0ibW96LXR4
dC1saW5rLWZyZWV0ZXh0IiBocmVmPSJodHRwOi8vbG9jYWxob3N0OjgwOTAvcmVxXzEiPmh0dHA6
Ly9sb2NhbGhvc3Q6ODA5MC9yZXFfMTwvYT48L2E+IiwKICAgICAgICAgICAgICAneyJ1c2VyIjoi
JGZVIn0nLCAiUkVRXzEiKTs8L2ZvbnQ+PC9kaXY+CiAgICAgICAgICA8ZGl2Pjxmb250IGZhY2U9
Im1vbm9zcGFjZSwgbW9ub3NwYWNlIj59PC9mb250PjwvZGl2PgogICAgICAgICAgPGRpdj48Zm9u
dCBmYWNlPSJtb25vc3BhY2UsIG1vbm9zcGFjZSI+PGJyPgogICAgICAgICAgICA8L2ZvbnQ+PC9k
aXY+CiAgICAgICAgICA8ZGl2Pjxmb250IGZhY2U9Im1vbm9zcGFjZSwgbW9ub3NwYWNlIj5yb3V0
ZVtSRVFfMV0gezwvZm9udD48L2Rpdj4KICAgICAgICAgIDxkaXY+PGZvbnQgZmFjZT0ibW9ub3Nw
YWNlLCBtb25vc3BhY2UiPqAgeGxvZygiTF9JTkZPIiwKICAgICAgICAgICAgICAicm91dGVbUkVR
XzFdOiBJTklUXG4iKTs8L2ZvbnQ+PC9kaXY+CiAgICAgICAgICA8ZGl2Pjxmb250IGZhY2U9Im1v
bm9zcGFjZSwgbW9ub3NwYWNlIj6gIGlmICgkaHR0cF9vaykgezwvZm9udD48L2Rpdj4KICAgICAg
ICAgIDxkaXY+PGZvbnQgZmFjZT0ibW9ub3NwYWNlLCBtb25vc3BhY2UiPqAgoCB4bG9nKCJMX0lO
Rk8iLAogICAgICAgICAgICAgICJyb3V0ZVtSRVFfMV06IHN0YXR1cyAkaHR0cF9yc1xuIik7PC9m
b250PjwvZGl2PgogICAgICAgICAgPGRpdj48Zm9udCBmYWNlPSJtb25vc3BhY2UsIG1vbm9zcGFj
ZSI+oCCgIHhsb2coIkxfSU5GTyIsCiAgICAgICAgICAgICAgInJvdXRlW1JFUV8xXTogU2VuZGlu
ZyBSRVFfMlxuIik7PC9mb250PjwvZGl2PgogICAgICAgICAgPGRpdj48Zm9udCBmYWNlPSJtb25v
c3BhY2UsIG1vbm9zcGFjZSI+oCCgIGh0dHBfYXN5bmNfcXVlcnkoIjxhCiAgICAgICAgICAgICAg
ICBtb3otZG8tbm90LXNlbmQ9InRydWUiCiAgICAgICAgICAgICAgICBocmVmPSJodHRwOi8vbG9j
YWxob3N0OjgwOTAvcmVxXzIiPjxhIGNsYXNzPSJtb3otdHh0LWxpbmstZnJlZXRleHQiIGhyZWY9
Imh0dHA6Ly9sb2NhbGhvc3Q6ODA5MC9yZXFfMiI+aHR0cDovL2xvY2FsaG9zdDo4MDkwL3JlcV8y
PC9hPjwvYT4iLAogICAgICAgICAgICAgICd7InVzZXIiOiIkZlUifScsICJSRVFfMiIpOzwvZm9u
dD48L2Rpdj4KICAgICAgICAgIDxkaXY+PGZvbnQgZmFjZT0ibW9ub3NwYWNlLCBtb25vc3BhY2Ui
PqAgfSBlbHNlIHs8L2ZvbnQ+PC9kaXY+CiAgICAgICAgICA8ZGl2Pjxmb250IGZhY2U9Im1vbm9z
cGFjZSwgbW9ub3NwYWNlIj6gIKAgeGxvZygiTF9JTkZPIiwKICAgICAgICAgICAgICAicm91dGVb
UkVRXzFdOiBlcnJvciCgJGh0dHBfZXJyKVxuIik7PC9mb250PjwvZGl2PgogICAgICAgICAgPGRp
dj48Zm9udCBmYWNlPSJtb25vc3BhY2UsIG1vbm9zcGFjZSI+oCB9PC9mb250PjwvZGl2PgogICAg
ICAgICAgPGRpdj48Zm9udCBmYWNlPSJtb25vc3BhY2UsIG1vbm9zcGFjZSI+fTwvZm9udD48L2Rp
dj4KICAgICAgICAgIDxkaXY+PGZvbnQgZmFjZT0ibW9ub3NwYWNlLCBtb25vc3BhY2UiPjxicj4K
ICAgICAgICAgICAgPC9mb250PjwvZGl2PgogICAgICAgICAgPGRpdj48Zm9udCBmYWNlPSJtb25v
c3BhY2UsIG1vbm9zcGFjZSI+cm91dGVbUkVRXzJdIHs8L2ZvbnQ+PC9kaXY+CiAgICAgICAgICA8
ZGl2Pjxmb250IGZhY2U9Im1vbm9zcGFjZSwgbW9ub3NwYWNlIj6gIHhsb2coIkxfSU5GTyIsCiAg
ICAgICAgICAgICAgInJvdXRlW1JFUV8yXTogSU5JVFxuIik7PC9mb250PjwvZGl2PgogICAgICAg
ICAgPGRpdj48Zm9udCBmYWNlPSJtb25vc3BhY2UsIG1vbm9zcGFjZSI+oCBpZiAoJGh0dHBfb2sp
IHs8L2ZvbnQ+PC9kaXY+CiAgICAgICAgICA8ZGl2Pjxmb250IGZhY2U9Im1vbm9zcGFjZSwgbW9u
b3NwYWNlIj6gIKAgeGxvZygiTF9JTkZPIiwKICAgICAgICAgICAgICAicm91dGVbUkVRXzJdOiBz
dGF0dXMgJGh0dHBfcnNcbiIpOzwvZm9udD48L2Rpdj4KICAgICAgICAgIDxkaXY+PGZvbnQgZmFj
ZT0ibW9ub3NwYWNlLCBtb25vc3BhY2UiPqAgfSBlbHNlIHs8L2ZvbnQ+PC9kaXY+CiAgICAgICAg
ICA8ZGl2Pjxmb250IGZhY2U9Im1vbm9zcGFjZSwgbW9ub3NwYWNlIj6gIKAgeGxvZygiTF9JTkZP
IiwKICAgICAgICAgICAgICAicm91dGVbUkVRXzJdOiBlcnJvciCgJGh0dHBfZXJyKVxuIik7PC9m
b250PjwvZGl2PgogICAgICAgICAgPGRpdj48Zm9udCBmYWNlPSJtb25vc3BhY2UsIG1vbm9zcGFj
ZSI+oCB9PC9mb250PjwvZGl2PgogICAgICAgICAgPGRpdj48Zm9udCBmYWNlPSJtb25vc3BhY2Us
IG1vbm9zcGFjZSI+fTwvZm9udD48L2Rpdj4KICAgICAgICAgIDxkaXY+PGZvbnQgZmFjZT0ibW9u
b3NwYWNlLCBtb25vc3BhY2UiPjxicj4KICAgICAgICAgICAgPC9mb250PjwvZGl2PgogICAgICAg
ICAgPGRpdj48Zm9udCBmYWNlPSJhcmlhbCwgaGVsdmV0aWNhLCBzYW5zLXNlcmlmIj5HZW5lcmF0
ZXMgdGhlCiAgICAgICAgICAgICAgZm9sbG93aW5nIGVycm9yOjwvZm9udD48L2Rpdj4KICAgICAg
ICAgIDxkaXY+PGZvbnQgZmFjZT0ibW9ub3NwYWNlLCBtb25vc3BhY2UiPjxicj4KICAgICAgICAg
ICAgPC9mb250PjwvZGl2PgogICAgICAgICAgPGRpdj4KICAgICAgICAgICAgPGRpdiBzdHlsZT0i
Zm9udC1mYW1pbHk6bW9ub3NwYWNlLG1vbm9zcGFjZSI+MTAoMTE4MzIpIElORk86CiAgICAgICAg
ICAgICAgJmx0O3NjcmlwdCZndDs6IHJvdXRlW1JFUV8xXTogSU5JVDwvZGl2PgogICAgICAgICAg
ICA8ZGl2IHN0eWxlPSJmb250LWZhbWlseTptb25vc3BhY2UsbW9ub3NwYWNlIj4xMCgxMTgzMikg
SU5GTzoKICAgICAgICAgICAgICAmbHQ7c2NyaXB0Jmd0Ozogcm91dGVbUkVRXzFdOiBzdGF0dXMg
MjAwPC9kaXY+CiAgICAgICAgICAgIDxkaXYgc3R5bGU9ImZvbnQtZmFtaWx5Om1vbm9zcGFjZSxt
b25vc3BhY2UiPjEwKDExODMyKSBJTkZPOgogICAgICAgICAgICAgICZsdDtzY3JpcHQmZ3Q7OiBy
b3V0ZVtSRVFfMV06IFNlbmRpbmcgUkVRXzI8L2Rpdj4KICAgICAgICAgICAgPGRpdiBzdHlsZT0i
Zm9udC1mYW1pbHk6bW9ub3NwYWNlLG1vbm9zcGFjZSI+MTAoMTE4MzIpCiAgICAgICAgICAgICAg
V0FSTklORzogdG0gW3Rfc3VzcGVuZC5jOjE4Nl06IHRfY29udGludWUoKTogdHJhbnNhY3Rpb24K
ICAgICAgICAgICAgICBpcyBub3Qgc3VzcGVuZGVkIFs1MzE5NTo1NjAzMDY4MzZdPC9kaXY+CiAg
ICAgICAgICAgIDxkaXYgc3R5bGU9ImZvbnQtZmFtaWx5Om1vbm9zcGFjZSxtb25vc3BhY2UiPjxi
cj4KICAgICAgICAgICAgPC9kaXY+CiAgICAgICAgICA8L2Rpdj4KICAgICAgICAgIDxkaXY+PGZv
bnQgZmFjZT0iYXJpYWwsIGhlbHZldGljYSwgc2Fucy1zZXJpZiI+TG9va2luZyBhdCB0aGUKICAg
ICAgICAgICAgICBzb3VyY2UsIGh0dHBfYXN5bmNfY2xpZW50IGNhbGxzIHRfc3VzcGVuZCwgdGhl
biBnb2VzIGF3YXkKICAgICAgICAgICAgICBhbmQgcGVyZm9ybXMgdGhlIHJlcXVlc3QgaW4gdGhl
IGJhY2tncm91bmQuIE9uIHJlc3BvbnNlIGl0CiAgICAgICAgICAgICAgY2FsbHMgdF9jb250aW51
ZSBhbmQgdGhlbqA8YSBtb3otZG8tbm90LXNlbmQ9InRydWUiCmhyZWY9Imh0dHBzOi8vZ2l0aHVi
LmNvbS9rYW1haWxpby9rYW1haWxpby9ibG9iLzQuNC9tb2R1bGVzL3RtL3Rfc3VzcGVuZC5jI0wy
NzAtTDI3NSI+dGhpcwogICAgICAgICAgICAgICAgYmxvY2s8L2E+IGluIHRfY29udGludWUgd2ls
bCBjb250aW51ZSBleGVjdXRpb24sIHRoZQogICAgICAgICAgICAgIHNlY29uZCBxdWVyeSB3aWxs
IGNhdXNlIGh0dHBfYXN5bmNfY2xpZW50IHRvIGNhbGwKICAgICAgICAgICAgICB0X3N1c3BlbmQg
d2hpbHN0IHNpbGwgZXhlY3V0aW5nIGZyb20KICAgICAgICAgICAgICB0aGWgcHJldmlvdXOgdF9j
b250aW51ZS6gT25jZSB0aGV5IHF1ZXJ5IGlzIHNlbnQsIHRoZQogICAgICAgICAgICAgIGZpcnN0
IHRfY29udGludWUgd2lsbCBjb21wbGV0ZSwgcmVtb3ZpbmcgdGhlCiAgICAgICAgICAgICAgVF9B
U1lOQ19TVVNQRU5ERUQgZmxhZy4gV2hlbiB0aGUgc2Vjb25kIHF1ZXJ5IHJldHVybnMgaXQKICAg
ICAgICAgICAgICBkb2Vzbid0IGZpbmQgdGhlIGZsYWcgYW5kIHNvIGZhaWxzIGFzIHNob3duLjwv
Zm9udD48L2Rpdj4KICAgICAgICAgIDxkaXY+PGZvbnQgZmFjZT0iYXJpYWwsIGhlbHZldGljYSwg
c2Fucy1zZXJpZiI+PGJyPgogICAgICAgICAgICA8L2ZvbnQ+PC9kaXY+CiAgICAgICAgICA8ZGl2
Pjxmb250IGZhY2U9ImFyaWFsLCBoZWx2ZXRpY2EsIHNhbnMtc2VyaWYiPkknbSBmYXIgZnJvbSBh
bgogICAgICAgICAgICAgIGV4cGVjdCBvbiB0aGlzIHNvIHdvdWxkIHJlYWxseSBhcHByZWNpYXRl
IHNvbWUgcG9pbnRlcnMsCiAgICAgICAgICAgICAgaXQgc2VlbXMgdG8gZnVuZGFtZW50YWwgdG8g
YmUgYSByYWNlIGNvbmRpdGlvbiBpbiB0bSBidXQKICAgICAgICAgICAgICB0aGUgdXNhZ2UgaW4g
aHR0cF9hc3luY19jbGllbnQgc2VlbXMgdG8gbWF0Y2ggdXNhZ2UgaW4KICAgICAgICAgICAgICBv
dGhlciBtb2R1bGVzIHNvIEknbSBub3Qgc3VyZSBvbiB0aGUgYmVzdCB0YWN0aWMuPC9mb250Pjwv
ZGl2PgogICAgICAgICAgPGRpdj48Zm9udCBmYWNlPSJhcmlhbCwgaGVsdmV0aWNhLCBzYW5zLXNl
cmlmIj5JJ3ZlIHRyaWVkCiAgICAgICAgICAgICAgcGVwcGVyaW5nIGFwcGVuZF9icmFuY2ggYW5k
IGFzeW5jX3JvdXRlIGNhbGwncyBpbiB2YXJpb3VzCiAgICAgICAgICAgICAgcGxhY2VzIHRvIG5v
IGF2YWlsLjwvZm9udD48L2Rpdj4KICAgICAgICAgIDxkaXY+PGZvbnQgZmFjZT0iYXJpYWwsIGhl
bHZldGljYSwgc2Fucy1zZXJpZiI+PGJyPgogICAgICAgICAgICA8L2ZvbnQ+PC9kaXY+CiAgICAg
ICAgICA8ZGl2Pjxmb250IGZhY2U9ImFyaWFsLCBoZWx2ZXRpY2EsIHNhbnMtc2VyaWYiPkZ1bGwg
ZGVidWcgbG9nCiAgICAgICAgICAgICAgaGVyZTqgPGEgbW96LWRvLW5vdC1zZW5kPSJ0cnVlIgog
ICAgICAgICAgICAgICAgaHJlZj0iaHR0cDovL3Bhc3RlYmluLmNvbS9yYXcvckZtbTBmbWYiPmh0
dHA6Ly9wYXN0ZWJpbi5jb20vcmF3L3JGbW0wZm1mPC9hPjwvZm9udD48L2Rpdj4KICAgICAgICAg
IDxkaXY+PGZvbnQgZmFjZT0iYXJpYWwsIGhlbHZldGljYSwgc2Fucy1zZXJpZiI+PGJyPgogICAg
ICAgICAgICA8L2ZvbnQ+PC9kaXY+CiAgICAgICAgICA8ZGl2Pjxmb250IGZhY2U9ImFyaWFsLCBo
ZWx2ZXRpY2EsIHNhbnMtc2VyaWYiPkFueSBoZWxwCiAgICAgICAgICAgICAgYXBwcmVjaWF0ZWQs
PC9mb250PjwvZGl2PgogICAgICAgICAgPGRpdj4KICAgICAgICAgICAgPGRpdiBjbGFzcz0iZ21h
aWxfc2lnbmF0dXJlIj4KICAgICAgICAgICAgICA8ZGl2IGRpcj0ibHRyIj4KICAgICAgICAgICAg
ICAgIDxkaXYgZGlyPSJsdHIiPgogICAgICAgICAgICAgICAgICA8ZGl2IGRpcj0ibHRyIj4KICAg
ICAgICAgICAgICAgICAgICA8cCBzdHlsZT0iY29sb3I6cmdiKDEzNiwxMzYsMTM2KSI+PGIKc3R5
bGU9ImNvbG9yOnJnYigwLDAsMCk7Zm9udC1mYW1pbHk6YXJpYWwsaGVsdmV0aWNhLHNhbnMtc2Vy
aWY7Zm9udC1zaXplOnNtYWxsIj5UaG9tCiAgICAgICAgICAgICAgICAgICAgICAgIFNlZGRvbjwv
Yj48L3A+CiAgICAgICAgICAgICAgICAgIDwvZGl2PgogICAgICAgICAgICAgICAgPC9kaXY+CiAg
ICAgICAgICAgICAgPC9kaXY+CiAgICAgICAgICAgIDwvZGl2PgogICAgICAgICAgPC9kaXY+CiAg
ICAgICAgPC9kaXY+CiAgICAgIDwvZGl2PgogICAgICA8YnI+CiAgICAgIDxmaWVsZHNldCBjbGFz
cz0ibWltZUF0dGFjaG1lbnRIZWFkZXIiPjwvZmllbGRzZXQ+CiAgICAgIDxicj4KICAgICAgPHBy
ZSB3cmFwPSIiPl9fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f
ClNJUCBFeHByZXNzIFJvdXRlciAoU0VSKSBhbmQgS2FtYWlsaW8gKE9wZW5TRVIpIC0gc3ItdXNl
cnMgbWFpbGluZyBsaXN0CjxhIGNsYXNzPSJtb3otdHh0LWxpbmstYWJicmV2aWF0ZWQiIGhyZWY9
Im1haWx0bzpzci11c2Vyc0BsaXN0cy5zaXAtcm91dGVyLm9yZyI+c3ItdXNlcnNAbGlzdHMuc2lw
LXJvdXRlci5vcmc8L2E+CjxhIGNsYXNzPSJtb3otdHh0LWxpbmstZnJlZXRleHQiIGhyZWY9Imh0
dHA6Ly9saXN0cy5zaXAtcm91dGVyLm9yZy9jZ2ktYmluL21haWxtYW4vbGlzdGluZm8vc3ItdXNl
cnMiPmh0dHA6Ly9saXN0cy5zaXAtcm91dGVyLm9yZy9jZ2ktYmluL21haWxtYW4vbGlzdGluZm8v
c3ItdXNlcnM8L2E+CjwvcHJlPgogICAgPC9ibG9ja3F1b3RlPgogICAgPGJyPgogICAgPHByZSBj
bGFzcz0ibW96LXNpZ25hdHVyZSIgY29scz0iNzIiPi0tIApEYW5pZWwtQ29uc3RhbnRpbiBNaWVy
bGEKPGEgY2xhc3M9Im1vei10eHQtbGluay1mcmVldGV4dCIgaHJlZj0iaHR0cDovL3d3dy5hc2lw
dG8uY29tIj5odHRwOi8vd3d3LmFzaXB0by5jb208L2E+IC0gPGEgY2xhc3M9Im1vei10eHQtbGlu
ay1mcmVldGV4dCIgaHJlZj0iaHR0cDovL3d3dy5rYW1haWxpby5vcmciPmh0dHA6Ly93d3cua2Ft
YWlsaW8ub3JnPC9hPgo8YSBjbGFzcz0ibW96LXR4dC1saW5rLWZyZWV0ZXh0IiBocmVmPSJodHRw
Oi8vdHdpdHRlci5jb20vIyEvbWljb25kYSI+aHR0cDovL3R3aXR0ZXIuY29tLyMhL21pY29uZGE8
L2E+IC0gPGEgY2xhc3M9Im1vei10eHQtbGluay1mcmVldGV4dCIgaHJlZj0iaHR0cDovL3d3dy5s
aW5rZWRpbi5jb20vaW4vbWljb25kYSI+aHR0cDovL3d3dy5saW5rZWRpbi5jb20vaW4vbWljb25k
YTwvYT48L3ByZT4KICA8L2JvZHk+CjwvaHRtbD4K

--===============1000275983==--