From nobody Sat May 18 13:36:45 2024 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1692793227604938.9417471243411; Wed, 23 Aug 2023 05:20:27 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qYmpr-0007rL-48; Wed, 23 Aug 2023 08:19:45 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qYmpk-0007r6-AP for qemu-devel@nongnu.org; Wed, 23 Aug 2023 08:19:37 -0400 Received: from casper.infradead.org ([2001:8b0:10b:1236::1]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qYmph-0008TA-6T for qemu-devel@nongnu.org; Wed, 23 Aug 2023 08:19:36 -0400 Received: from 54-240-197-239.amazon.com ([54.240.197.239] helo=edge-infra-2.e-lhr50.amazon.com) by casper.infradead.org with esmtpsa (Exim 4.94.2 #2 (Red Hat Linux)) id 1qYmpc-004lCE-8X; Wed, 23 Aug 2023 12:19:28 +0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; h=MIME-Version:Content-Type:Date:Cc:To: From:Subject:Message-ID:Sender:Reply-To:Content-Transfer-Encoding:Content-ID: Content-Description:In-Reply-To:References; bh=4CcfEOVa4buxHgdu/wiyoSqwecLusPPUmTOMhiK4xJk=; b=PuFKXl+TPbZjqu5f25QtvGnKcL lCCLl4JwqMTei7prjdRb3w1sXejx+wHPMOquntOGzfcuHw+FaPH7AJG86MAbSJeiyZZFhZ1Q53BA+ 7oU7sXNKHgFp55Un6U7rKbt8WFzwfjh+5zXI1gY6gNOEN52dKENkWad+04fq3iFcdxEBronx32178 9KvzDOJJ3TgaZJ9v+3YBEY6VIOpyn1N2TOzDvvVEVwh2bcgxhDlju/3iRow16QBVVzuLkgYL9NU1U rrV6qM5TM8yi8w/iSjBjFFXfYLqMsMGq1Cp1Divojd+tMbad5uGUkFRdNQgTxDkk03Q+jmxFPFrEF 0H4dU/dw==; Message-ID: Subject: [PATCH v2] hw/xen: Clean up event channel 'type_val' handling to use union From: David Woodhouse To: paul@xen.org, qemu-devel Cc: Paolo Bonzini , Richard Henderson , Eduardo Habkost , "Michael S. Tsirkin" , Marcel Apfelbaum Date: Wed, 23 Aug 2023 13:19:27 +0100 Content-Type: multipart/signed; micalg="sha-256"; protocol="application/pkcs7-signature"; boundary="=-bGdTSQWnISVzLeINSaHb" User-Agent: Evolution 3.44.4-0ubuntu2 MIME-Version: 1.0 X-SRS-Rewrite: SMTP reverse-path rewritten from by casper.infradead.org. See http://www.infradead.org/rpr.html Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: none client-ip=2001:8b0:10b:1236::1; envelope-from=BATV+3e2b8733669f2ff7871f+7304+infradead.org+dwmw2@casper.srs.infradead.org; helo=casper.infradead.org X-Spam_score_int: -43 X-Spam_score: -4.4 X-Spam_bar: ---- X-Spam_report: (-4.4 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_MED=-2.3, SPF_HELO_NONE=0.001, SPF_NONE=0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer=patchew.org@nongnu.org X-Zoho-Virus-Status: 1 X-Zoho-AV-Stamp: zmail-av-1.1.0/192.695.32 X-ZohoMail-DKIM: fail (Header signature does not verify) X-ZM-MESSAGEID: 1692793230136100003 --=-bGdTSQWnISVzLeINSaHb Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" From: David Woodhouse A previous implementation of this stuff used a 64-bit field for all of the port information (vcpu/type/type_val) and did atomic exchanges on them. When I implemented that in Qemu I regretted my life choices and just kept it simple with locking instead. So there's no need for the XenEvtchnPort to be so simplistic. We can use a union for the pirq/virq/interdomain information, which lets us keep a separate bit for the 'remote domain' in interdomain ports. A single bit is enough since the only possible targets are loopback or qemu itself. So now we can ditch PORT_INFO_TYPEVAL_REMOTE_QEMU and the horrid manual masking, although the in-memory representation is identical so there's no change in the saved state ABI. Signed-off-by: David Woodhouse Reviewed-by: Paul Durrant --- v2: Minor cosmetic nits from Paul's review, completely remove the definition of PORT_INFO_TYPEVAL_REMOTE_QEMU and _PORT_MASK. hw/i386/kvm/xen_evtchn.c | 151 ++++++++++++++++++--------------------- 1 file changed, 70 insertions(+), 81 deletions(-) diff --git a/hw/i386/kvm/xen_evtchn.c b/hw/i386/kvm/xen_evtchn.c index a731738411..4df973022c 100644 --- a/hw/i386/kvm/xen_evtchn.c +++ b/hw/i386/kvm/xen_evtchn.c @@ -58,7 +58,15 @@ OBJECT_DECLARE_SIMPLE_TYPE(XenEvtchnState, XEN_EVTCHN) typedef struct XenEvtchnPort { uint32_t vcpu; /* Xen/ACPI vcpu_id */ uint16_t type; /* EVTCHNSTAT_xxxx */ - uint16_t type_val; /* pirq# / virq# / remote port according to type */ + union { + uint16_t val; /* raw value for serialization etc. */ + uint16_t pirq; + uint16_t virq; + struct { + uint16_t port:15; + uint16_t to_qemu:1; /* Only two targets; qemu or loopback */ + } interdomain; + } u; } XenEvtchnPort; =20 /* 32-bit compatibility definitions, also used natively in 32-bit build */ @@ -105,14 +113,6 @@ struct xenevtchn_handle { int fd; }; =20 -/* - * For unbound/interdomain ports there are only two possible remote - * domains; self and QEMU. Use a single high bit in type_val for that, - * and the low bits for the remote port number (or 0 for unbound). - */ -#define PORT_INFO_TYPEVAL_REMOTE_QEMU 0x8000 -#define PORT_INFO_TYPEVAL_REMOTE_PORT_MASK 0x7FFF - /* * These 'emuirq' values are used by Xen in the LM stream... and yes, I am * insane enough to think about guest-transparent live migration from actu= al @@ -210,16 +210,16 @@ static int xen_evtchn_post_load(void *opaque, int ver= sion_id) XenEvtchnPort *p =3D &s->port_table[i]; =20 if (p->type =3D=3D EVTCHNSTAT_pirq) { - assert(p->type_val); - assert(p->type_val < s->nr_pirqs); + assert(p->u.pirq); + assert(p->u.pirq < s->nr_pirqs); =20 /* * Set the gsi to IRQ_UNBOUND; it may be changed to an actual * GSI# below, or to IRQ_MSI_EMU when the MSI table snooping * catches up with it. */ - s->pirq[p->type_val].gsi =3D IRQ_UNBOUND; - s->pirq[p->type_val].port =3D i; + s->pirq[p->u.pirq].gsi =3D IRQ_UNBOUND; + s->pirq[p->u.pirq].port =3D i; } } /* Rebuild s->pirq[].gsi mapping */ @@ -243,7 +243,7 @@ static const VMStateDescription xen_evtchn_port_vmstate= =3D { .fields =3D (VMStateField[]) { VMSTATE_UINT32(vcpu, XenEvtchnPort), VMSTATE_UINT16(type, XenEvtchnPort), - VMSTATE_UINT16(type_val, XenEvtchnPort), + VMSTATE_UINT16(u.val, XenEvtchnPort), VMSTATE_END_OF_LIST() } }; @@ -599,14 +599,13 @@ static void unbind_backend_ports(XenEvtchnState *s) =20 for (i =3D 1; i < s->nr_ports; i++) { p =3D &s->port_table[i]; - if (p->type =3D=3D EVTCHNSTAT_interdomain && - (p->type_val & PORT_INFO_TYPEVAL_REMOTE_QEMU)) { - evtchn_port_t be_port =3D p->type_val & PORT_INFO_TYPEVAL_REMO= TE_PORT_MASK; + if (p->type =3D=3D EVTCHNSTAT_interdomain && p->u.interdomain.to_q= emu) { + evtchn_port_t be_port =3D p->u.interdomain.port; =20 if (s->be_handles[be_port]) { /* This part will be overwritten on the load anyway. */ p->type =3D EVTCHNSTAT_unbound; - p->type_val =3D PORT_INFO_TYPEVAL_REMOTE_QEMU; + p->u.interdomain.port =3D 0; =20 /* Leave the backend port open and unbound too. */ if (kvm_xen_has_cap(EVTCHN_SEND)) { @@ -644,30 +643,22 @@ int xen_evtchn_status_op(struct evtchn_status *status) =20 switch (p->type) { case EVTCHNSTAT_unbound: - if (p->type_val & PORT_INFO_TYPEVAL_REMOTE_QEMU) { - status->u.unbound.dom =3D DOMID_QEMU; - } else { - status->u.unbound.dom =3D xen_domid; - } + status->u.unbound.dom =3D p->u.interdomain.to_qemu ? DOMID_QEMU + : xen_domid; break; =20 case EVTCHNSTAT_interdomain: - if (p->type_val & PORT_INFO_TYPEVAL_REMOTE_QEMU) { - status->u.interdomain.dom =3D DOMID_QEMU; - } else { - status->u.interdomain.dom =3D xen_domid; - } - - status->u.interdomain.port =3D p->type_val & - PORT_INFO_TYPEVAL_REMOTE_PORT_MASK; + status->u.interdomain.dom =3D p->u.interdomain.to_qemu ? DOMID_QEMU + : xen_domid; + status->u.interdomain.port =3D p->u.interdomain.port; break; =20 case EVTCHNSTAT_pirq: - status->u.pirq =3D p->type_val; + status->u.pirq =3D p->u.pirq; break; =20 case EVTCHNSTAT_virq: - status->u.virq =3D p->type_val; + status->u.virq =3D p->u.virq; break; } =20 @@ -983,7 +974,7 @@ static int clear_port_pending(XenEvtchnState *s, evtchn= _port_t port) static void free_port(XenEvtchnState *s, evtchn_port_t port) { s->port_table[port].type =3D EVTCHNSTAT_closed; - s->port_table[port].type_val =3D 0; + s->port_table[port].u.val =3D 0; s->port_table[port].vcpu =3D 0; =20 if (s->nr_ports =3D=3D port + 1) { @@ -1006,7 +997,7 @@ static int allocate_port(XenEvtchnState *s, uint32_t v= cpu, uint16_t type, if (s->port_table[p].type =3D=3D EVTCHNSTAT_closed) { s->port_table[p].vcpu =3D vcpu; s->port_table[p].type =3D type; - s->port_table[p].type_val =3D val; + s->port_table[p].u.val =3D val; =20 *port =3D p; =20 @@ -1047,15 +1038,15 @@ static int close_port(XenEvtchnState *s, evtchn_por= t_t port, return -ENOENT; =20 case EVTCHNSTAT_pirq: - s->pirq[p->type_val].port =3D 0; - if (s->pirq[p->type_val].is_translated) { + s->pirq[p->u.pirq].port =3D 0; + if (s->pirq[p->u.pirq].is_translated) { *flush_kvm_routes =3D true; } break; =20 case EVTCHNSTAT_virq: - kvm_xen_set_vcpu_virq(virq_is_global(p->type_val) ? 0 : p->vcpu, - p->type_val, 0); + kvm_xen_set_vcpu_virq(virq_is_global(p->u.virq) ? 0 : p->vcpu, + p->u.virq, 0); break; =20 case EVTCHNSTAT_ipi: @@ -1065,8 +1056,8 @@ static int close_port(XenEvtchnState *s, evtchn_port_= t port, break; =20 case EVTCHNSTAT_interdomain: - if (p->type_val & PORT_INFO_TYPEVAL_REMOTE_QEMU) { - uint16_t be_port =3D p->type_val & ~PORT_INFO_TYPEVAL_REMOTE_Q= EMU; + if (p->u.interdomain.to_qemu) { + uint16_t be_port =3D p->u.interdomain.port; struct xenevtchn_handle *xc =3D s->be_handles[be_port]; if (xc) { if (kvm_xen_has_cap(EVTCHN_SEND)) { @@ -1076,14 +1067,15 @@ static int close_port(XenEvtchnState *s, evtchn_por= t_t port, } } else { /* Loopback interdomain */ - XenEvtchnPort *rp =3D &s->port_table[p->type_val]; - if (!valid_port(p->type_val) || rp->type_val !=3D port || + XenEvtchnPort *rp =3D &s->port_table[p->u.interdomain.port]; + if (!valid_port(p->u.interdomain.port) || + rp->u.interdomain.port !=3D port || rp->type !=3D EVTCHNSTAT_interdomain) { error_report("Inconsistent state for interdomain unbind"); } else { /* Set the other end back to unbound */ rp->type =3D EVTCHNSTAT_unbound; - rp->type_val =3D 0; + rp->u.interdomain.port =3D 0; } } break; @@ -1207,7 +1199,7 @@ int xen_evtchn_bind_vcpu_op(struct evtchn_bind_vcpu *= vcpu) if (p->type =3D=3D EVTCHNSTAT_interdomain || p->type =3D=3D EVTCHNSTAT_unbound || p->type =3D=3D EVTCHNSTAT_pirq || - (p->type =3D=3D EVTCHNSTAT_virq && virq_is_global(p->type_val))) { + (p->type =3D=3D EVTCHNSTAT_virq && virq_is_global(p->u.virq))) { /* * unmask_port() with do_unmask=3D=3Dfalse will just raise the eve= nt * on the new vCPU if the port was already pending. @@ -1352,19 +1344,15 @@ int xen_evtchn_bind_ipi_op(struct evtchn_bind_ipi *= ipi) int xen_evtchn_bind_interdomain_op(struct evtchn_bind_interdomain *interdo= main) { XenEvtchnState *s =3D xen_evtchn_singleton; - uint16_t type_val; int ret; =20 if (!s) { return -ENOTSUP; } =20 - if (interdomain->remote_dom =3D=3D DOMID_QEMU) { - type_val =3D PORT_INFO_TYPEVAL_REMOTE_QEMU; - } else if (interdomain->remote_dom =3D=3D DOMID_SELF || - interdomain->remote_dom =3D=3D xen_domid) { - type_val =3D 0; - } else { + if (interdomain->remote_dom !=3D DOMID_QEMU && + interdomain->remote_dom !=3D DOMID_SELF && + interdomain->remote_dom !=3D xen_domid) { return -ESRCH; } =20 @@ -1375,8 +1363,8 @@ int xen_evtchn_bind_interdomain_op(struct evtchn_bind= _interdomain *interdomain) qemu_mutex_lock(&s->port_lock); =20 /* The newly allocated port starts out as unbound */ - ret =3D allocate_port(s, 0, EVTCHNSTAT_unbound, type_val, - &interdomain->local_port); + ret =3D allocate_port(s, 0, EVTCHNSTAT_unbound, 0, &interdomain->local= _port); + if (ret) { goto out; } @@ -1401,7 +1389,8 @@ int xen_evtchn_bind_interdomain_op(struct evtchn_bind= _interdomain *interdomain) assign_kernel_eventfd(lp->type, xc->guest_port, xc->fd); } lp->type =3D EVTCHNSTAT_interdomain; - lp->type_val =3D PORT_INFO_TYPEVAL_REMOTE_QEMU | interdomain->remo= te_port; + lp->u.interdomain.to_qemu =3D 1; + lp->u.interdomain.port =3D interdomain->remote_port; ret =3D 0; } else { /* Loopback */ @@ -1409,19 +1398,18 @@ int xen_evtchn_bind_interdomain_op(struct evtchn_bi= nd_interdomain *interdomain) XenEvtchnPort *lp =3D &s->port_table[interdomain->local_port]; =20 /* - * The 'remote' port for loopback must be an unbound port allocate= d for - * communication with the local domain (as indicated by rp->type_v= al - * being zero, not PORT_INFO_TYPEVAL_REMOTE_QEMU), and must *not* = be - * the port that was just allocated for the local end. + * The 'remote' port for loopback must be an unbound port allocated + * for communication with the local domain, and must *not* be the + * port that was just allocated for the local end. */ if (interdomain->local_port !=3D interdomain->remote_port && - rp->type =3D=3D EVTCHNSTAT_unbound && rp->type_val =3D=3D 0) { + rp->type =3D=3D EVTCHNSTAT_unbound && !rp->u.interdomain.to_qe= mu) { =20 rp->type =3D EVTCHNSTAT_interdomain; - rp->type_val =3D interdomain->local_port; + rp->u.interdomain.port =3D interdomain->local_port; =20 lp->type =3D EVTCHNSTAT_interdomain; - lp->type_val =3D interdomain->remote_port; + lp->u.interdomain.port =3D interdomain->remote_port; } else { ret =3D -EINVAL; } @@ -1440,7 +1428,6 @@ int xen_evtchn_bind_interdomain_op(struct evtchn_bind= _interdomain *interdomain) int xen_evtchn_alloc_unbound_op(struct evtchn_alloc_unbound *alloc) { XenEvtchnState *s =3D xen_evtchn_singleton; - uint16_t type_val; int ret; =20 if (!s) { @@ -1451,18 +1438,20 @@ int xen_evtchn_alloc_unbound_op(struct evtchn_alloc= _unbound *alloc) return -ESRCH; } =20 - if (alloc->remote_dom =3D=3D DOMID_QEMU) { - type_val =3D PORT_INFO_TYPEVAL_REMOTE_QEMU; - } else if (alloc->remote_dom =3D=3D DOMID_SELF || - alloc->remote_dom =3D=3D xen_domid) { - type_val =3D 0; - } else { + if (alloc->remote_dom !=3D DOMID_QEMU && + alloc->remote_dom !=3D DOMID_SELF && + alloc->remote_dom !=3D xen_domid) { return -EPERM; } =20 qemu_mutex_lock(&s->port_lock); =20 - ret =3D allocate_port(s, 0, EVTCHNSTAT_unbound, type_val, &alloc->port= ); + ret =3D allocate_port(s, 0, EVTCHNSTAT_unbound, 0, &alloc->port); + + if (!ret && alloc->remote_dom =3D=3D DOMID_QEMU) { + XenEvtchnPort *p =3D &s->port_table[alloc->port]; + p->u.interdomain.to_qemu =3D 1; + } =20 qemu_mutex_unlock(&s->port_lock); =20 @@ -1489,12 +1478,12 @@ int xen_evtchn_send_op(struct evtchn_send *send) =20 switch (p->type) { case EVTCHNSTAT_interdomain: - if (p->type_val & PORT_INFO_TYPEVAL_REMOTE_QEMU) { + if (p->u.interdomain.to_qemu) { /* * This is an event from the guest to qemu itself, which is * serving as the driver domain. */ - uint16_t be_port =3D p->type_val & ~PORT_INFO_TYPEVAL_REMOTE_Q= EMU; + uint16_t be_port =3D p->u.interdomain.port; struct xenevtchn_handle *xc =3D s->be_handles[be_port]; if (xc) { eventfd_write(xc->fd, 1); @@ -1504,7 +1493,7 @@ int xen_evtchn_send_op(struct evtchn_send *send) } } else { /* Loopback interdomain ports; just a complex IPI */ - set_port_pending(s, p->type_val); + set_port_pending(s, p->u.interdomain.port); } break; =20 @@ -1546,8 +1535,7 @@ int xen_evtchn_set_port(uint16_t port) =20 /* QEMU has no business sending to anything but these */ if (p->type =3D=3D EVTCHNSTAT_virq || - (p->type =3D=3D EVTCHNSTAT_interdomain && - (p->type_val & PORT_INFO_TYPEVAL_REMOTE_QEMU))) { + (p->type =3D=3D EVTCHNSTAT_interdomain && p->u.interdomain.to_qemu= )) { set_port_pending(s, port); ret =3D 0; } @@ -2057,7 +2045,7 @@ int xen_be_evtchn_bind_interdomain(struct xenevtchn_h= andle *xc, uint32_t domid, switch (gp->type) { case EVTCHNSTAT_interdomain: /* Allow rebinding after migration, preserve port # if possible */ - be_port =3D gp->type_val & ~PORT_INFO_TYPEVAL_REMOTE_QEMU; + be_port =3D gp->u.interdomain.port; assert(be_port !=3D 0); if (!s->be_handles[be_port]) { s->be_handles[be_port] =3D xc; @@ -2078,7 +2066,8 @@ int xen_be_evtchn_bind_interdomain(struct xenevtchn_h= andle *xc, uint32_t domid, } =20 gp->type =3D EVTCHNSTAT_interdomain; - gp->type_val =3D be_port | PORT_INFO_TYPEVAL_REMOTE_QEMU; + gp->u.interdomain.to_qemu =3D 1; + gp->u.interdomain.port =3D be_port; xc->guest_port =3D guest_port; if (kvm_xen_has_cap(EVTCHN_SEND)) { assign_kernel_eventfd(gp->type, guest_port, xc->fd); @@ -2123,7 +2112,7 @@ int xen_be_evtchn_unbind(struct xenevtchn_handle *xc,= evtchn_port_t port) /* This should never *not* be true */ if (gp->type =3D=3D EVTCHNSTAT_interdomain) { gp->type =3D EVTCHNSTAT_unbound; - gp->type_val =3D PORT_INFO_TYPEVAL_REMOTE_QEMU; + gp->u.interdomain.port =3D 0; } =20 if (kvm_xen_has_cap(EVTCHN_SEND)) { @@ -2277,11 +2266,11 @@ EvtchnInfoList *qmp_xen_event_list(Error **errp) =20 info->type =3D p->type; if (p->type =3D=3D EVTCHNSTAT_interdomain) { - info->remote_domain =3D g_strdup((p->type_val & PORT_INFO_TYPE= VAL_REMOTE_QEMU) ? + info->remote_domain =3D g_strdup(p->u.interdomain.to_qemu ? "qemu" : "loopback"); - info->target =3D p->type_val & PORT_INFO_TYPEVAL_REMOTE_PORT_M= ASK; + info->target =3D p->u.interdomain.port; } else { - info->target =3D p->type_val; + info->target =3D p->u.val; /* pirq# or virq# */ } info->vcpu =3D p->vcpu; info->pending =3D test_bit(i, pending); --=20 2.34.1 --=-bGdTSQWnISVzLeINSaHb Content-Type: application/pkcs7-signature; name="smime.p7s" Content-Disposition: attachment; filename="smime.p7s" Content-Transfer-Encoding: base64 MIAGCSqGSIb3DQEHAqCAMIACAQExDzANBglghkgBZQMEAgEFADCABgkqhkiG9w0BBwEAAKCCEkQw ggYQMIID+KADAgECAhBNlCwQ1DvglAnFgS06KwZPMA0GCSqGSIb3DQEBDAUAMIGIMQswCQYDVQQG EwJVUzETMBEGA1UECBMKTmV3IEplcnNleTEUMBIGA1UEBxMLSmVyc2V5IENpdHkxHjAcBgNVBAoT FVRoZSBVU0VSVFJVU1QgTmV0d29yazEuMCwGA1UEAxMlVVNFUlRydXN0IFJTQSBDZXJ0aWZpY2F0 aW9uIEF1dGhvcml0eTAeFw0xODExMDIwMDAwMDBaFw0zMDEyMzEyMzU5NTlaMIGWMQswCQYDVQQG EwJHQjEbMBkGA1UECBMSR3JlYXRlciBNYW5jaGVzdGVyMRAwDgYDVQQHEwdTYWxmb3JkMRgwFgYD VQQKEw9TZWN0aWdvIExpbWl0ZWQxPjA8BgNVBAMTNVNlY3RpZ28gUlNBIENsaWVudCBBdXRoZW50 aWNhdGlvbiBhbmQgU2VjdXJlIEVtYWlsIENBMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC AQEAyjztlApB/975Rrno1jvm2pK/KxBOqhq8gr2+JhwpKirSzZxQgT9tlC7zl6hn1fXjSo5MqXUf ItMltrMaXqcESJuK8dtK56NCSrq4iDKaKq9NxOXFmqXX2zN8HHGjQ2b2Xv0v1L5Nk1MQPKA19xeW QcpGEGFUUd0kN+oHox+L9aV1rjfNiCj3bJk6kJaOPabPi2503nn/ITX5e8WfPnGw4VuZ79Khj1YB rf24k5Ee1sLTHsLtpiK9OjG4iQRBdq6Z/TlVx/hGAez5h36bBJMxqdHLpdwIUkTqT8se3ed0PewD ch/8kHPo5fZl5u1B0ecpq/sDN/5sCG52Ds+QU5O5EwIDAQABo4IBZDCCAWAwHwYDVR0jBBgwFoAU U3m/WqorSs9UgOHYm8Cd8rIDZsswHQYDVR0OBBYEFAnA8vwL2pTbX/4r36iZQs/J4K0AMA4GA1Ud DwEB/wQEAwIBhjASBgNVHRMBAf8ECDAGAQH/AgEAMB0GA1UdJQQWMBQGCCsGAQUFBwMCBggrBgEF BQcDBDARBgNVHSAECjAIMAYGBFUdIAAwUAYDVR0fBEkwRzBFoEOgQYY/aHR0cDovL2NybC51c2Vy dHJ1c3QuY29tL1VTRVJUcnVzdFJTQUNlcnRpZmljYXRpb25BdXRob3JpdHkuY3JsMHYGCCsGAQUF BwEBBGowaDA/BggrBgEFBQcwAoYzaHR0cDovL2NydC51c2VydHJ1c3QuY29tL1VTRVJUcnVzdFJT QUFkZFRydXN0Q0EuY3J0MCUGCCsGAQUFBzABhhlodHRwOi8vb2NzcC51c2VydHJ1c3QuY29tMA0G CSqGSIb3DQEBDAUAA4ICAQBBRHUAqznCFfXejpVtMnFojADdF9d6HBA4kMjjsb0XMZHztuOCtKF+ xswhh2GqkW5JQrM8zVlU+A2VP72Ky2nlRA1GwmIPgou74TZ/XTarHG8zdMSgaDrkVYzz1g3nIVO9 IHk96VwsacIvBF8JfqIs+8aWH2PfSUrNxP6Ys7U0sZYx4rXD6+cqFq/ZW5BUfClN/rhk2ddQXyn7 kkmka2RQb9d90nmNHdgKrwfQ49mQ2hWQNDkJJIXwKjYA6VUR/fZUFeCUisdDe/0ABLTI+jheXUV1 eoYV7lNwNBKpeHdNuO6Aacb533JlfeUHxvBz9OfYWUiXu09sMAviM11Q0DuMZ5760CdO2VnpsXP4 KxaYIhvqPqUMWqRdWyn7crItNkZeroXaecG03i3mM7dkiPaCkgocBg0EBYsbZDZ8bsG3a08LwEsL 1Ygz3SBsyECa0waq4hOf/Z85F2w2ZpXfP+w8q4ifwO90SGZZV+HR/Jh6rEaVPDRF/CEGVqR1hiuQ OZ1YL5ezMTX0ZSLwrymUE0pwi/KDaiYB15uswgeIAcA6JzPFf9pLkAFFWs1QNyN++niFhsM47qod x/PL+5jR87myx5uYdBEQkkDc+lKB1Wct6ucXqm2EmsaQ0M95QjTmy+rDWjkDYdw3Ms6mSWE3Bn7i 5ZgtwCLXgAIe5W8mybM2JzCCBhQwggT8oAMCAQICEQDGvhmWZ0DEAx0oURL6O6l+MA0GCSqGSIb3 DQEBCwUAMIGWMQswCQYDVQQGEwJHQjEbMBkGA1UECBMSR3JlYXRlciBNYW5jaGVzdGVyMRAwDgYD VQQHEwdTYWxmb3JkMRgwFgYDVQQKEw9TZWN0aWdvIExpbWl0ZWQxPjA8BgNVBAMTNVNlY3RpZ28g UlNBIENsaWVudCBBdXRoZW50aWNhdGlvbiBhbmQgU2VjdXJlIEVtYWlsIENBMB4XDTIyMDEwNzAw MDAwMFoXDTI1MDEwNjIzNTk1OVowJDEiMCAGCSqGSIb3DQEJARYTZHdtdzJAaW5mcmFkZWFkLm9y ZzCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBALQ3GpC2bomUqk+91wLYBzDMcCj5C9m6 oZaHwvmIdXftOgTbCJXADo6G9T7BBAebw2JV38EINgKpy/ZHh7htyAkWYVoFsFPrwHounto8xTsy SSePMiPlmIdQ10BcVSXMUJ3Juu16GlWOnAMJY2oYfEzmE7uT9YgcBqKCo65pTFmOnR/VVbjJk4K2 xE34GC2nAdUQkPFuyaFisicc6HRMOYXPuF0DuwITEKnjxgNjP+qDrh0db7PAjO1D4d5ftfrsf+kd RR4gKVGSk8Tz2WwvtLAroJM4nXjNPIBJNT4w/FWWc/5qPHJy2U+eITZ5LLE5s45mX2oPFknWqxBo bQZ8a9dsZ3dSPZBvE9ZrmtFLrVrN4eo1jsXgAp1+p7bkfqd3BgBEmfsYWlBXO8rVXfvPgLs32VdV NZxb/CDWPqBsiYv0Hv3HPsz07j5b+/cVoWqyHDKzkaVbxfq/7auNVRmPB3v5SWEsH8xi4Bez2V9U KxfYCnqsjp8RaC2/khxKt0A552Eaxnz/4ly/2C7wkwTQnBmdlFYhAflWKQ03Ufiu8t3iBE3VJbc2 5oMrglj7TRZrmKq3CkbFnX0fyulB+kHimrt6PIWn7kgyl9aelIl6vtbhMA+l0nfrsORMa4kobqQ5 C5rveVgmcIad67EDa+UqEKy/GltUwlSh6xy+TrK1tzDvAgMBAAGjggHMMIIByDAfBgNVHSMEGDAW gBQJwPL8C9qU21/+K9+omULPyeCtADAdBgNVHQ4EFgQUzMeDMcimo0oz8o1R1Nver3ZVpSkwDgYD VR0PAQH/BAQDAgWgMAwGA1UdEwEB/wQCMAAwHQYDVR0lBBYwFAYIKwYBBQUHAwQGCCsGAQUFBwMC MEAGA1UdIAQ5MDcwNQYMKwYBBAGyMQECAQEBMCUwIwYIKwYBBQUHAgEWF2h0dHBzOi8vc2VjdGln by5jb20vQ1BTMFoGA1UdHwRTMFEwT6BNoEuGSWh0dHA6Ly9jcmwuc2VjdGlnby5jb20vU2VjdGln b1JTQUNsaWVudEF1dGhlbnRpY2F0aW9uYW5kU2VjdXJlRW1haWxDQS5jcmwwgYoGCCsGAQUFBwEB BH4wfDBVBggrBgEFBQcwAoZJaHR0cDovL2NydC5zZWN0aWdvLmNvbS9TZWN0aWdvUlNBQ2xpZW50 QXV0aGVudGljYXRpb25hbmRTZWN1cmVFbWFpbENBLmNydDAjBggrBgEFBQcwAYYXaHR0cDovL29j c3Auc2VjdGlnby5jb20wHgYDVR0RBBcwFYETZHdtdzJAaW5mcmFkZWFkLm9yZzANBgkqhkiG9w0B AQsFAAOCAQEAyW6MUir5dm495teKqAQjDJwuFCi35h4xgnQvQ/fzPXmtR9t54rpmI2TfyvcKgOXp qa7BGXNFfh1JsqexVkIqZP9uWB2J+uVMD+XZEs/KYNNX2PvIlSPrzIB4Z2wyIGQpaPLlYflrrVFK v9CjT2zdqvy2maK7HKOQRt3BiJbVG5lRiwbbygldcALEV9ChWFfgSXvrWDZspnU3Gjw/rMHrGnql Htlyebp3pf3fSS9kzQ1FVtVIDrL6eqhTwJxe+pXSMMqFiN0whpBtXdyDjzBtQTaZJ7zTT/vlehc/ tDuqZwGHm/YJy883Ll+GP3NvOkgaRGWEuYWJJ6hFCkXYjyR9IzCCBhQwggT8oAMCAQICEQDGvhmW Z0DEAx0oURL6O6l+MA0GCSqGSIb3DQEBCwUAMIGWMQswCQYDVQQGEwJHQjEbMBkGA1UECBMSR3Jl YXRlciBNYW5jaGVzdGVyMRAwDgYDVQQHEwdTYWxmb3JkMRgwFgYDVQQKEw9TZWN0aWdvIExpbWl0 ZWQxPjA8BgNVBAMTNVNlY3RpZ28gUlNBIENsaWVudCBBdXRoZW50aWNhdGlvbiBhbmQgU2VjdXJl IEVtYWlsIENBMB4XDTIyMDEwNzAwMDAwMFoXDTI1MDEwNjIzNTk1OVowJDEiMCAGCSqGSIb3DQEJ ARYTZHdtdzJAaW5mcmFkZWFkLm9yZzCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBALQ3 GpC2bomUqk+91wLYBzDMcCj5C9m6oZaHwvmIdXftOgTbCJXADo6G9T7BBAebw2JV38EINgKpy/ZH h7htyAkWYVoFsFPrwHounto8xTsySSePMiPlmIdQ10BcVSXMUJ3Juu16GlWOnAMJY2oYfEzmE7uT 9YgcBqKCo65pTFmOnR/VVbjJk4K2xE34GC2nAdUQkPFuyaFisicc6HRMOYXPuF0DuwITEKnjxgNj P+qDrh0db7PAjO1D4d5ftfrsf+kdRR4gKVGSk8Tz2WwvtLAroJM4nXjNPIBJNT4w/FWWc/5qPHJy 2U+eITZ5LLE5s45mX2oPFknWqxBobQZ8a9dsZ3dSPZBvE9ZrmtFLrVrN4eo1jsXgAp1+p7bkfqd3 BgBEmfsYWlBXO8rVXfvPgLs32VdVNZxb/CDWPqBsiYv0Hv3HPsz07j5b+/cVoWqyHDKzkaVbxfq/ 7auNVRmPB3v5SWEsH8xi4Bez2V9UKxfYCnqsjp8RaC2/khxKt0A552Eaxnz/4ly/2C7wkwTQnBmd lFYhAflWKQ03Ufiu8t3iBE3VJbc25oMrglj7TRZrmKq3CkbFnX0fyulB+kHimrt6PIWn7kgyl9ae lIl6vtbhMA+l0nfrsORMa4kobqQ5C5rveVgmcIad67EDa+UqEKy/GltUwlSh6xy+TrK1tzDvAgMB AAGjggHMMIIByDAfBgNVHSMEGDAWgBQJwPL8C9qU21/+K9+omULPyeCtADAdBgNVHQ4EFgQUzMeD Mcimo0oz8o1R1Nver3ZVpSkwDgYDVR0PAQH/BAQDAgWgMAwGA1UdEwEB/wQCMAAwHQYDVR0lBBYw FAYIKwYBBQUHAwQGCCsGAQUFBwMCMEAGA1UdIAQ5MDcwNQYMKwYBBAGyMQECAQEBMCUwIwYIKwYB BQUHAgEWF2h0dHBzOi8vc2VjdGlnby5jb20vQ1BTMFoGA1UdHwRTMFEwT6BNoEuGSWh0dHA6Ly9j cmwuc2VjdGlnby5jb20vU2VjdGlnb1JTQUNsaWVudEF1dGhlbnRpY2F0aW9uYW5kU2VjdXJlRW1h aWxDQS5jcmwwgYoGCCsGAQUFBwEBBH4wfDBVBggrBgEFBQcwAoZJaHR0cDovL2NydC5zZWN0aWdv LmNvbS9TZWN0aWdvUlNBQ2xpZW50QXV0aGVudGljYXRpb25hbmRTZWN1cmVFbWFpbENBLmNydDAj BggrBgEFBQcwAYYXaHR0cDovL29jc3Auc2VjdGlnby5jb20wHgYDVR0RBBcwFYETZHdtdzJAaW5m cmFkZWFkLm9yZzANBgkqhkiG9w0BAQsFAAOCAQEAyW6MUir5dm495teKqAQjDJwuFCi35h4xgnQv Q/fzPXmtR9t54rpmI2TfyvcKgOXpqa7BGXNFfh1JsqexVkIqZP9uWB2J+uVMD+XZEs/KYNNX2PvI lSPrzIB4Z2wyIGQpaPLlYflrrVFKv9CjT2zdqvy2maK7HKOQRt3BiJbVG5lRiwbbygldcALEV9Ch WFfgSXvrWDZspnU3Gjw/rMHrGnqlHtlyebp3pf3fSS9kzQ1FVtVIDrL6eqhTwJxe+pXSMMqFiN0w hpBtXdyDjzBtQTaZJ7zTT/vlehc/tDuqZwGHm/YJy883Ll+GP3NvOkgaRGWEuYWJJ6hFCkXYjyR9 IzGCBMcwggTDAgEBMIGsMIGWMQswCQYDVQQGEwJHQjEbMBkGA1UECBMSR3JlYXRlciBNYW5jaGVz dGVyMRAwDgYDVQQHEwdTYWxmb3JkMRgwFgYDVQQKEw9TZWN0aWdvIExpbWl0ZWQxPjA8BgNVBAMT NVNlY3RpZ28gUlNBIENsaWVudCBBdXRoZW50aWNhdGlvbiBhbmQgU2VjdXJlIEVtYWlsIENBAhEA xr4ZlmdAxAMdKFES+jupfjANBglghkgBZQMEAgEFAKCCAeswGAYJKoZIhvcNAQkDMQsGCSqGSIb3 DQEHATAcBgkqhkiG9w0BCQUxDxcNMjMwODIzMTIxOTI3WjAvBgkqhkiG9w0BCQQxIgQghr5fvCSK t+3IZiC/9RMOXcMedhMycEvAWWepLNoe0jAwgb0GCSsGAQQBgjcQBDGBrzCBrDCBljELMAkGA1UE BhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2FsZm9yZDEYMBYG A1UEChMPU2VjdGlnbyBMaW1pdGVkMT4wPAYDVQQDEzVTZWN0aWdvIFJTQSBDbGllbnQgQXV0aGVu dGljYXRpb24gYW5kIFNlY3VyZSBFbWFpbCBDQQIRAMa+GZZnQMQDHShREvo7qX4wgb8GCyqGSIb3 DQEJEAILMYGvoIGsMIGWMQswCQYDVQQGEwJHQjEbMBkGA1UECBMSR3JlYXRlciBNYW5jaGVzdGVy MRAwDgYDVQQHEwdTYWxmb3JkMRgwFgYDVQQKEw9TZWN0aWdvIExpbWl0ZWQxPjA8BgNVBAMTNVNl Y3RpZ28gUlNBIENsaWVudCBBdXRoZW50aWNhdGlvbiBhbmQgU2VjdXJlIEVtYWlsIENBAhEAxr4Z lmdAxAMdKFES+jupfjANBgkqhkiG9w0BAQEFAASCAgA3DfUe0c1uDAYajTert+BzuiMpABjI1b53 XMMT2unCvAVsl/YYg1Do6nUZ/N29Lbfws1kqIrbKHjkTqvSsq1r7NC78jW+tJX50O68IviE1N3cX Czzx6jKwQqJwFwUHq7plHHXSXL5Rj8QNplh6wfYc08sb82+0Y2S31FopeuyrJ2kjBm+6+LkHh/lP Y7T0oQbC2lkyOT1OrevHx5zyplJOUlPmwOy/fuzdoJXo+OW8JqtTdRA4jYBQtOPcpAvseirnZEha 8t3ViYmgcSz2AoFryfcknUJZvt03hdQyT0/zrb6EvDEmmCF8zZsJSoGy1jT1LxLENj+sws/5Sdhq Irh5S+UWg9kR9z9jj71Huh6lHkWoIstsDbaNgZOr1gtRcGGETPTftbkoaIXj33HQKgfqPFJNaZ3Y NM4r4yGvAZqkiVM5X+Xqs/nrnJvOBIXEvy/0xh+JQUtPyJMimPfhi766LsLlTbS+K7sCtQiX8JfL 282az41g9PETAkS7ny9VU0pYtjvHQEvLdpB50qzoTtJAD0HXQiYpftMO2RLVx1EvYX+/yI26YU1D bOSujrhu50wiCb6AS6CW4PM+dH/SnuMyN9cLYeS/ksILElfgWO8lW6y1gUhxZUKjCW6ShMzRHB9R 2tW+w8aPus7U4xXfNb4mTIssh/IsQmEUaNvca5VbbwAAAAAAAA== --=-bGdTSQWnISVzLeINSaHb--